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INTRODUCTION 


This manual is intended for use with Burroughs Network Architecture (BNA) by 
programming and computer operations personnel. Additionally, the information 
can be used by network/system planning personnel who require detailed 
information of BNA operations. 


lt is assumed that the reader has a basic understanding of the operation of 
Burroughs computer systems and data communications, and has studied the 
Burroughs Network Architecture (BNA) Reference Manual, Volume |, form 1132172. 


This manual describes the interface messages that are associated with BNA 
Network Services. These messages are used to _ control, configure, and 
interrogate various BNA Network Services functions. 


This is a general Burroughs systems document, not particular to any specific 
system. Where specific system information is required, the particular system 
publication should be referred to. This manual and any = system publication 
should be considered as a set for a given system installation. 


For the operator (ODT agent) this manual serves as a reference to all 
operational commands and responses; however, it must be used in conjunction with 
a specific system publication that describes the precise entry of commands” and 
display formatting. 


For the programmer who is writing Program Agent programs, this manual serves as 
a reference to all messages to or from the Operations Interface. However, this 
issue of the manual does not include the encoded detail for the messages. The 
encoded detail will be provided in a later revision. Meanwhile, the manual 
provides valuable Program Agent planning information. 


Generally, this manual is divided into logical functions, closely following the 
modes of a BNA node.: A brief synopsis of the sections follows: 


Section 1 deals with the general topics of the Operations Interface and 
the commands and responses that traverse this interface. It also 
includes an introductory discussion on the general layout and format of 
the manual. : 


Sections 2 through 9 describe the detailed syntax and semantics of 
commands and responses. However, unlike many operation manuals, this 
manual groups the commands and responses’ into their functional 
classifications rather than a collated sequence. A comprehensive’ index 
is provided at the rear of the manual that is ordered alphabetically and 
can be used to locate commands, both in the complete form and in_ the 
mnemonic form. Other indexes are also provided to aid in locating other 
items of interest. 


Section 10 describes the formats of the unsolicited responses (Reports). 


The Appendixes contain reference information for the use of this manual, 
such as indexes, railroad, and syntax rules, and miscellaneous 
operations related subjects. 


vil 


SECTION 1 
GENERAL 


The Operations Interface is the means whereby an agent external to BNA, such as 
a human operator, a program, or a file, can exchange control information with a 
BNA node. These messages can be used by the external agent: 


1. To initialize the node into the network. 

2. To make inquiries about the status of the tables and attributes. 
3. To define and modify the node's network configuration. 

4. To change certain operating parameters. 

5. To initiate a specific action. 

6. To be informed of and to handle exception conditions. 

7. To remove (shut down) the node from the network. 


8. To perform testing and maintenance. 
e 
This manual describes the command and response messages that are used to monitor 
and control] a BNA node within a BNA network. The messages, which are called 
Operations Interface Messages (O!1Ms), have message formats that are the same for 
all systems. However, there are also some system-dependent features and 
limitations that must be considered for actual operating procedures. For 
details of the features and limitations of a system, refer to the publication 
for that particular system. 


For system operation, both this manual and the system-dependent manuals should 
be consulted. For planning purposes, this manua | provides sufficient 
information to understand the operating features of BNA. 


NOTE 
In designing the network architecture, a great effort was 
made to make al] BNA systems conform to an identical set 
of operating messages. In general this goal was met. 
However, there will be some differences, particularly 
with responses. Therefore, although this manual attempts 


to describe output messages (responses) in precise 
detail, some differences in responses can be expected. 
‘These differences involve the type of format or actual 
content, but the response will be such that an operator 
can readily recognize the response intent. For Program 
Agents, the encoded responses (to be provided in a later 
issue) will be precise; no interpretation of intent wil] 


be needed. 
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As previously mentioned, this manual is organized logically, but within logical 
groupings, items are ordered alphabetically, where possible. Where the reader 
cannot easily find a specific item, a comprehensive index is provided in 
Appendix C. 


The following subsection describes the general order and layout of the message 
descriptions used in this manual. 


GENERAL COMMAND DESCRIPTION FORMAT 


The general order of command descriptions presented in this document is: 


command syntax 
semantics 
servicing phase 
default values 
examples 
response syntax 
error messages 


In those instances where little detail is needed, only relevant parts are 
included. A brief description of each follows: 


Command Svntax 


The command syntax describes the precise format by use of railroad syntax 
diagrams. Refer to Appendix A for railroad rules and common. syntactic 
elements. 


Semantics 


A brief description of the command and its effect is given. 


Servicing Phase 


This part describes any restrictions as to when the command can be entered. 
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Default Value 


When attributes have predefined default values, the values are listed. 


Examples 


Examples of the form of the commands, and in some cases the form of the 
positive response, are given for each command. 


Response Syntax 


The syntax for the positive response is described by use of railroad 
diagrams. 


Where the inquiry form of command results in a different response, both 
response constructs are shown under the subtitles of ‘'‘'command' response 
syntax'' and "inquiry response syntax". 


Error Messages 


For every command there is a corresponding set of possible error 
conditions. With the exception of those described under Negative Responses 
and Error Messages in this section, all error messages are shown with’ the 
command. To aid in finding error message meanings, error messages are 
indexed in Appendixes at the end of this manual. 


Section | 
General 


AGENTS 


Agents can be operators, programs, or files that exchange messages with a BNA 
node. The types of agents and their operations are described in the following 
paragraphs. 


OPERATOR DISPLAY TERMINAL (ODT) AGENTS 


ODT agents are external agents that can be human operators working through a 
console. ODT agents can be local or remote to a node: 


1. Local agents are the local host operating system console and any 
"remote'’ station defined as an QDT: 


2. Remote agents are agents operating from input devices attached to a 
remote node. 


OPERATIONS INTERFACE MESSAGE (OIM) FILE AGENTS 


OIM file agents are disk files that contain Operations Interface Messages. 
Their operation is controlled by Service commands. Refer to Section 8 for 
further details on Service commands. 


PROGRAM AGENTS 


Program Agents are user written programs which can send and receive Operations 
Interface Messages. 


Program Agents communicate with the Operations Interface through a Network 
Services port. They become Program Agents by nature of their function and their 
suitable security qualifications. Refer to Section 3, Program Agent Control. 


The agent can be local to the Node being controlled, or remote, in which case 


the BNA network itself is used to establish and maintain. this remote 
communication. 
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TYPES OF MESSAGES 


The three types of Operations Interface Messages are Commands, Responses, and 
Reports. A description of each follows: 


1. Commands are OIMs originated by the agent and sent to the BNA _ node. 
These messages are used to inquire about the state of the node, to change 
the operating behavior of the node (by changing the values of 
attributes), to define and modify the node's network configuration, and 
to initiate some activity within the node. 


Zs Responses are OIMs which are generated by the node as a direct result of 
receiving a command, and these are sent to the agent. Responses are 
positive if the intent of the corresponding command was_- successfully 
completed within the node. Responses are negative if the command was 
erroneous. or the command could not be honored for any reason. 


3. Reports are unsolicited messages sent by the node to the agent, usually 
indicating the occurrence of some event in the node. 


Additionally, there are messages that are functional requirements for _ BNA 
Network Services but are not members of the OIM command set. Messages that fal] 
under this category are HN (Host Name), and AT (At remote host). 


HN (host name) 


The HN function identifies the host name of the local system which 
supports BNA. The host name is supplied during system initialization. 


'While any user program is running, or any ports are open, the node _ host 
name identity cannot be changed. 


Examples 


HN 
=> HOSTNAME = "RED" 


HN GREEN 
=> HOSTNAME CHANGED FROM "'RED" TO '"'GREEN'' 
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AT (AT host ODT input) 


AT <hostname> <input message> 


The AT command is recognized by the local host as an ODT input message 
that is destined for a remote host. The local host does not check’ the 
message, but passes the message to Host Services for onward transmission 
to the remote host. The remote host acts upon the message, as though it 
were received from a local ODT subsystem, and returns any responses” to 
the originating host. 


Examples 


Refer to specific system documentation for examples of this command. 


CLASSIFICATION OF COMMANDS 


The Operations Interface Commands are grouped according to the class of function 
which they perform. Certain classes of commands can be entered at certain 
phases of the node operation. 


The classes of commands, their general function, and the phase of the node 


during which they can be entered, are shown in figure 1-1] and are described in 
the following paragraphs. 
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MODE COMMANDS 


NET + ENDINIT NET - 
| | | 
Vv Vv Vv 
tet ea a ee ee ee ee RETURNS TO 
| ISOLATED | NETWORK MODE | 
| MODE | |{ ISOLATED MODE 
posses sean 2} Ss Se SS as Se Ss ERS SSS SS SS Se SSS esses Ss SSS sss sess 
| | NETWORK INITIALIZATION PHASES | | | 
| ISOLATED +-------—-------------—---—-—--- —+ NETWORK | LEVEL |{ RETURNS TO 
| | INIT DATA ENTRY | | | SHUT- || ISOLATED 
| OPERATING+------—---— +-—-------+ AWAITING | OPERATING | DOWN | 
| ATTRIBUTE | CONFIG. | LEVEL | | PHASES| OPERATING 
| PHASE | ENTRY [| ENTRY | INIT | PHASE | | PHASE 
| | | PHASE | PHASE | | 
+------- +f --- ——- -- — -- Sh ee ee eee ee 
4+—------~-~-----—-- +--+ —- —- + - — -- — - - + + —+ 
| ATTRIBUTE | 
4+---——-— —+ ENTRY 4+------------~~—---- —---- ---- +--+ —+ 
: | COMMANDS | ; ‘ : 
, 4+-—------ —---+ : : i 
t+-—- — —- —-. ee aah eata Cease ase ereayin we ee ee +-—---—++ 
| OPERA- . TIONAL | | 
pen ies Soaktniie-s Spite weee. COMMANDS +-------—+ 
. ‘ : +————------ —-+ ‘ 
: 2 qe. eee tmnt en + é 
, , | CONFIGURA- -TIONAL COMMDS| : 
: 4+---------- occ ee eee enn nan= + ; 
f : ni nnn —+ 
; , | STATION- -MANUAL COMMANDS | 
‘ P nn ee nn —+ 
$--------- —- +--+ -- ~~ +--+ - +--+ -- +--+ +--+ —+ 
pea a- + INQUIRY COMMANDS | 
4+--—-—------------- ----- + -- — ----- + +--+ —+ 
ht er rn rr en rn et rrr ne enn —+ 
+-—-—-—--- —+ SERVICE COMMANDS | 
+———-~--~---------~+--- --- +--+ -- --- +--+ -- — - + —+ 
Figure 1-1. Classification of Operations Interface Commands 
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Mode Commands 


Mode commands cause mode or phase changes of the node. The commands NET and 
ENDINIT are used to move from Isolated mode to Network mode and to start the 
Network shutdown phase of the node. 


Attribute Entry Commands 


Attribute entry commands set the Network Services attributes in the various 
Network Services Managers. These attributes are used during the initialization 
phase of the node to declare the node identity, to select certain operating 
options, to supply values for parameters which "tune'' the performance of the 
node, and, in some implementations, to set the limits for resource utilization. 


Most of these attributes possess default values, so that they need not be set; a 
few are required to be set during Network initialization. 


After Network initialization, during the operating phase of the node, some of 
these attributes can be changed. A few can also be changed during the Isolated 
operating phase. 


Configurational Commands 


Configurational commands generate and change the network configuration 
information within the node. They define the hosts and nodes with which the 
local node is to communicate, and they set up information used to connect to 
neighbor nodes, defining a set of stations and their attributes. 


These commands are operationally inert; they neither initiate nor terminate 
communications and connections. They simply set up information which then can be 
used by the Operational Commands to perform such functions. 


Conf igurational commands can be entered in Network mode any time after the 
Attribute Entry phase of the node, except during shutdown. In fact, the entry 
of the first Configurational command indicates the end of the Attribute Entry 
and the beginning of the Configuration Entry phase of the Level Managers. 


Operational Commands 


Operational commands can be entered only during the operating phases of the 
node. In Network mode, these commands cause the local node to act relative to 
the network: to initiate or terminate communications with and connections. to 
other nodes in the network, and to make or break associations with Program 
Agents. 
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Station Manual Commands 


Station Manual commands are used to establish confidence in the proper operation 
of the Stations. Together with inquiry commands, they can be used to diagnose 
problems. They can be entered at any time after the Attribute Entry phase of 
Network initialization. 


Inquiry Commands 


Inquiry commands have no effect on the activity or performance of the node. 
They only retrieve information, and can be entered at any time. However, in 
lsolated mode, many of these commands have no meaning and are rejected if 
entered. 


Inquiry commands are the most numerous commands and are used for a wide range of 


purposes, from very general, summary-type information gathering, to very 
detailed examination of attributes for fault isolation. 


Service Commands 


Service commands control the activity of OIM input files and handle the 
disposition of responses to commands. They can be entered at any time. 


ISOLATED MODE COMMANDS 


When the node is in Isolated mode, that is, prior to Network Services 
initialization, most Operations Interface commands are not serviceable. The 
response to entering such commands is: ''NOT IN NETWORK MODE", and the command is 
rejected. 


There are a few, however, which are meaningful. These are listed below; their 
syntax and semantics are described later in this document. 

Attribute Entry: 

PORT LOG INTERVAL 


Mode Change: 


NET ("NET = ', "NET + "' forms can be entered) 
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Configurational: 


No commands of this class can be entered. 
Operational: 

No commands of this class can be entered. 
Inquiry: 


HN (host name), PORT LOG INTERVAL, CANDIDATE, NET. 


FORM OF COMMANDS FROM AGENTS 


The syntax of OIMs is the same for ODT and File Agents; Program Agents use an 
encoded form of the same messages. Although similar, each kind of agent 
possesses certain characteristics which affect the form of the OIM. These are 
described in the following paragraphs. 


ODT COMMANDS 


When an agent uses a medium through which system input messages (system ODT 
messages) are also entered, the OIM messages form a subset of these ODT 
messages. To distinguish 01M Commands from other system input messages, either 
the OIM Commands are prefixed with ''NW'' and followed by at least one space, or 
the ODT is dedicated for network operations. A description of the NW prefix and 
the DEDICATE command follows: 


NW Prefix 


Command Syntax 


NWS)" SOM, COMIgnda HH Hess Ss Senet Sr orese teen ress Se rs = = 


There are, however, several exceptions to this rule: 


1. The HN (host name) command, the AT command, the PORT LOG’ INTERVAL 
command, the CANDIDATE command, and all forms of the NET command must 
not use the NW prefix. ; 


Section | 
General Form of Commands from Agents 


DEDICATED 


2. ODT agents which are dedicated do not use this prefix while operating in 
this way. An ODT agent can become dedicated by using the DEDICATED 
command. 


NOTE 
The mode of the host, whether Isolated or Networking, has 
no bearing on this rule. 


Dedicate Command 


DEDICATED s=<>= + wee een eee ee eee | 


Semantics 


For the ODT agent entering this command, it turns on or off the requirement for 
prefixing an OIM command with NW. This command can be entered only by ODT 
agents. 


COMMANDS FROM OIM INPUT FILES 


The OIM input file is composed of a series of records of 72 or more characters 
in length. The first 72 characters form the text field. Characters 73-80 can 
be either not present, all blank, or strictly mumeric; if numeric, they are 
treated as a sequence number. Any additional characters in the record are not 
used. 


Commands are separated by semicolons. A single command can continue from one 
text field of a record onto the text field of the next sequential record, 


provided that no words or numbers are split from one record to another. In 
fact, the end of a record serves as a delimiter to separate words, just as 
spaces and special characters do. A percent sign (%) indicates that the 


remainder of the record is a comment. The percent sign is treated just as 
though the end of record has been reached. 


INITIALIZATION FILE 


The initialization file ts a special case of the OIM input file. It is read 
during the Network Initialization phase of the node. It is identical in format 
to any other OIM file, and contains commands which are meaningful during’ the 
initialization of the node into Network mode. 
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PROGRAM AGENTS 


The form of commands from Program Agents, communicated by means of the 
Operations Interface Handler Port and Subport, are encoded. This issue does not 
provide the syntax for the Program Agent communication; later revisions will 
provide the syntax when it is available. 


FORM OF RESPONSES AND REPORTS TO AGENTS 


Every command has associated with it a response, either positive or negative. In 
addition, there are reports that are unsolicited responses from Network Services 
levels. These form the output messages of Network Services Operations 
Interface. 


Throughout this manual the responses to commands are described with the command 
syntax, both for the inquiry form of the command and for the response to. the 
action of a command. Additionally, Section 10 describes unsolicited messages, 
called reports. 


Responses are normally returned to the agent entering the command. Reports are 
normally returned to an ODT agent. Options that allow diverting and inhibiting 
responses and reports are described in the Response Steering subsection (later 
in this section). 


Reports and responses to agents take on different forms for different agents. 
The following paragraphs describe these forms. 


ODT AGENTS 


Responses and Reports appear as described by the syntax. However, some systems 
prefix output messages with origin information (such as mix number), or simply 
an indication which visibly differentiates between input and output images. In 
general, the visual images of the OI1M output Messages are consistent with other 
output messages in a particular system. 


OIM PRINTER (OR PRINTER BACKUP) MESSAGES 


Responses can be diverted to a printer or printer backup file. Responses” sent 
to this file are formatted in the same way as those sent to any other agent; 
they vary only in accordance with the record size property of the medium used. 
For details, refer to Response Steering subsection. 


PROGRAM AGENTS 


Each response or report is contained in a single message communicated through 
the agent's Port and Subport. The form of the response is encoded. Details of 
the encoding will be provided in later revisions of this manual. 
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HANDLING OF OPERATIONS INTERFACE MESSAGES 


For each command entered through the Operations Interface, an immediate 
response, positive or negative, is returned. How commands are sequenced, and 
where responses and reports are sent, depend on the agent. 


ODT AGENT 


Commands entering through the ODT interface are accepted one at a time, and a 
response is given before the next command is accepted. The ODT subsystem (which 
is outside of Network Services, and within the operating system) can provide for 
queueing input messages and for manipulating that queue in the event of errors. 


Responses to commands entered through an ODT are returned to that ODT. However, 
it is possible for the ODT agent to specify that responses be sent to a printer. 


Reports from the node are normally sent to the ODT agent. Responses caused by 
Initialization file commands are sent to the ODT agent. 


OIM INPUT FILES 


Commands entering through an input file are received in the order they appear on 
the file, until: (1) the end of the file is encountered, (2) a command results 
in an error, or (3) a STOP command is entered by the ODT agent or encountered in 
the file itself. A syntax error causes the loading of the file to be aborted; 
any other negative responses suspend the file. 


If an ENDINIT command is encountered in an initialization file, and there are 
additional commands appearing on that file after the ENDINIT, the file reading 
is temporarily suspended until the node phase change to Network Operating mode 
is complete. 


Except for those responses which are explicitly diverted or inhibited, responses 
to commands from OIM files are sent to the ODT agent. 


PROGRAM AGENTS 


Commands are received from the Program Agent, and responses to these commands 
are returned to the program agent. The next command is accepted only after a 
response to the previous command has been returned. Errors do not’ terminate 
communication with the Program Agent. 


NEGATIVE RESPONSES AND ERROR MESSAGES 


Negative responses are generated for commands which are syntactically invalid or 
which cannot be serviced for any reason. Negative responses are formatted as 
follows: *k*k <error message> : <copy of oim command> 


Section | 
Negative Responses and Error Messages General 


SYNTAX ERRORS 


A syntax error is any error which is detectable by scanning the command without 
having to service it or to know by what agent or during what mode the command is 
entered. 

Examples of syntax errors are: 


1. Incorrect keywords. 


2 Violation of the sequence of syntactic elements as specified by the 
railroad diagram. 


3 Syntactically-improper images for names, integers, strings, time 
intervals, file titles, and so forth. 


4. Improper use of syntactic marks, such as commas, parentheses, brackets, 
colons. 

5. Incorrect attribute names. 

6. incorrect values for attributes which have enumerated mnemonic 


representations. 


The syntax error message describes, as closely as possible, the nature and 
location of the error. 


A syntax error encountered in reading an OIM input file causes the reading of 
that file to be aborted (rather than simply suspended, as other errors do). 


NOTE 
Because syntax errors apply to every OIM command, they 
are discussed here in detail, but are not repeated with 
the description of each command. 


OTHER ERRORS 


Unlike syntax errors, all other errors are detectable only by knowing in what 
phase of the node the command was entered, the identity of the agent, or by 
servicing the command. Certain errors apply to nearly all commands. Therefore, 
instead of repeating them with the description of each command, they are 
presented here: 


UNAUTHOR! ZED AGENT 
- the agent entering that command is not authorized to do so. 


NOT IN NETWORK MODE 
- a network command is entered while in Isolated mode. 


1-14 


Section | 
General Negative Responses and Error Messages 


IMPROPER PHASE 
- the command cannot be entered in the current phase of the node. 


ALL REQUIRED ATTRIBUTES HAVE NOT BEEN SET 
- if the Attribute Entry phase is exited, and all the required attributes 
have not been set. The required attributes are: LOCALIDENTITY, plus any 
system-specific ones. The Attribute Entry phase is exited by entering the 
first Configurational command, or by entering the ENDINITIALIZATION command. 


The following general error messages apply to many Inquiry Commands: 
INVALID NODE ADDRESS 


NO SUCH <entity> 
- the entity referenced does not exist. These are: 


host node usercode 
station ensemble profile 
file agent using process 


Note that some Inquiry commands have no meaning while the node is in Isolated 
mode. When this happens, negative responses are not returned (they do not 
suspend the reading of an OIM input file, for example); instead the no-op- type 
of positive response "NOT IN NETWORK MODE" is returned. 


RESPONSE STEERING 


Responses are returned to the agent entering the command associated with that 
response. An exception to this rule is for OIM input files (which are input 
only); in this case responses are sent to the ODT agent. 


However, an agent can specify that the response to a command be diverted to a 
printer, or be inhibited (not returned at all). This is true for all responses 
except syntax errors. Syntax errors can neither be diverted nor inhibited; they 
are unconditionally returned to the agent entering the command. If syntax 
errors are encountered by commands entered from an input file agent, the error 
messages are unconditionally sent to the ODT agent. 
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RELEASE Section 1 
REPORTS Response Steertng. General 


To invoke alternate response options, the following can be appended to = any 
command: 


S25 “SO 1M=COMMaNas 22 = See ees ale See eS ee eee creer sae a= ee 
|. soso PRINTER =e" 


. INHIBIT --- 


There exists one printer file for all agents, and it can be released for 
printing by the following command: 


RELEASE --- PRINTER --------------- | 


Reports can be received by all authorized agents (refer to Access Control 
Commands). Normally, the system ODT is designated, by default, to receive al] 
reports. Any other agents are required to request reports by entering’ the 
REPORTS command. Note that only authorized agents, authorized to receive 
reports, will be granted reports. 


To turn on or turn off the receiving of reports by an agent, the. following 
command is entered: 


REPORTS ------------------------------- weennne- 


The agent entering this command can apply this option only to itself, and not on 
behalf of any other agent. By default, an ODT agent receives reports; a Program 
Agent does not. 


REPORTS without the + or - sign inquires about setting of this option. The 
response is either REPORTS + or REPORTS -. 
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NET 


SECTION 2 
MODE COMMANDS 


The Mode commands move the node to or from the Network mode. 


NET COMMAND 


Command Syntax 


where <init-file> is: ------ SPL =title> =s<-ss<->-> 


- #NULL ---------- 


- *DEFAULT ------- 


NOTE 
For the inquiry form of the command, refer to Section 9, 
Summary: NET. 
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Section 2 
NET 


Mode Commands 


Semantics 

NET = <init-file> form: 
The file information replaces the current value of the NEXT INIT FILE 
title. The next time the node is initializing into Network mode, it will 


use the information supplied by this command. 


lf <file-title> is supplied, this file becomes the NEXT INIT FILE; the next 


NET + command will use this for initialization. !f *NULL is specified, no 
initialization file is automatically used; some other agent must supply the 
required commands for the node initialization into Network mode. | f 
*DEFAULT is supplied, the <init-file> value reverts to the system initial 


value. 
NET + form: 


This specifies that the node is to move from Isolated mode into Network 
mode. The Network initialization proceeds, and the NEXT INIT FILE is used. 


NET + <init-file> form: 


This produces the same effect as entering NET = <init-file>, followed by 
NET +. 


NET - form: 
This specifies that the network operation is to be shut down, and thus_ the 
mode is to change from Network to Isolated. This shut-down is to. take 
effect after the deactivation of all local subports that were in 


communication with remote ports. 


NET - NOW form: 


This is the same as "NET -'"', except that all subports in communication with 
remote hosts (ports) are deactivated immediately. 


NET - CANCEL form: 


This rescinds a previous NET - command, provided that the Port Level has 
not yet completed its Network mode shutdown. 
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Mode Commands 


Section 2 NET 


Servicing Mode 


The NET = form (with just file information) or NET (inquiry) can be entered at 


any time. The NET + form can be entered only in Isolated mode; the NET - form 
cand be entered only in Network mode. The NET - CANCEL command can be entered 
only while a NET - or NET - NOW command is being serviced. 


Default Value 
The NET + form must be entered in order for the node to go from tsolated mode 
into Network mode. However, where a system can specify that the node be 


initialized directly into Network mode, NET + need not be used. All other forms 
of the NET command are optional. 


Response Syntax 


for NET + => INITIALIZING NETWORK MODE 


for NET - => SHUTTING DOWN NETWORK MODE 


Error Messages 


SHUTDOWN CANNOT BE CANCELLED 
- if the NET ~ CANCEL command arrived too late to be honored. 
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ENDINIT Section 2 


Mode Commands 


ENDINIT COMMAND 


Command Syntax 


This command declares the end of the data entry phase of the node's 
initialization into Network mode. If ENDINIT appears in a file, and other 
commands follow it in that file, reading of the file is suspended until the 
phase change caused by ENDINIT is completed. 

Servicing. Mode 

ENDINIT can be entered only in the Initialization Data Entry phase of Network 
mode. 


Default Value 


The ENDINIT command is required. 


Response Syntax 


INITITALIZATION DATA ENTRY PHASE COMPLETE 


Error Messages 
ALL REQUIRED ATTRIBUTES HAVE NOT BEEN SET 


- if ENDINIT is entered before the LOC and HN attributes required for 
Network initialization have been entered. 
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NODEPASSWORD 


SECTION 3 
ACCESS CONTROL COMMANDS 


The following access control commands are used to control access to node 
resources, and agent privileges. 


NODE PASSWORD COMMAND 
NOTE 


This command applies only to systems which permit the 
entry of Node Passwords through the Operations Interface. 


Command Syntax 


NODEPASSWORD! “== <NoSst+namé> -mfass testes reese a a Ses toes s > 


-- #<node-address> -- 


== #<node-address> <---s----ses-se2->- 


< ee me ee oe ow ome me oe Se em ey em oe Oe oe me oe oe oe om me me ee oe ee ee oe oe me om Oe ow ow ae ae oe oe oe oe ee oe oe oe ow oe oe we we oe oe ee 
SS Soe= MYNODEPASSWORD --------- *SS2 <5 tinige: =-sSsss+se=s- | 
- YOURNODEPASSWORD --- ~ HEX <hex-number> - 
- *NULL ------------ 
password range: <string>, 1 to 17 characters 


or <hex-number>, 1 to 17 hex digits pairs. 
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Section 3 


NODEPASSWORD Access Control Commands 


Semantics 


This command is used to add or delete the passwords that nodes’ send to. each 
other during greeting processes. 


NODEPASSWORD <node> MYNODEPASSWORD = <password>: 
This form of the command sets or cnanges the password which is sent by the 
local node to the specified node in the Station Level and Port Level 
greetings. 


NODEPASSWORD <node> YOURNODEPASSWORD = <password>: 


This form sets or changes the password that the local node expects from the 
specified node in greeting messages. 


Passwords are deleted by entering '"*NULL'' in place of the password. 


where <password> is defined as: 


Shore MSA ing. Pessoa s se ase 


- HEX <hex-number> - 


NOTE 
-coee THERE !S NO INQUIRY =ORM FOR THIS COMMAND ----- 
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Section 3 


Access Control Commands NOD EPASSWORD 
Default Value 
The default value for all passwords is null (that is, no. password). Null 


passwords can be explicitly entered by using the delete form of the command or 
by entering *NULL in place of the password. 


Examples 
NODEPASSWORD RED #2 MYNODEPASSWORD = ZZ YOURNODEPASSWORD = YY 


NPW RED #2 MNPW = ZZ YNPW = YY 
NPW BLUE MNPW = "##abc'' YNPW = HEX 99AABB 


Response Syntax 


NODEPASSWORD CHANGED FOR <host-name> #<node-address> 


Error Messages 


ILLEGAL. PASSWORD 
- passwords exceeds range of characters or digits. 


NO SUCH HOST OR NODE 
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AUTHORIZE Section 3 


Access Control Commands 


USER AUTHORIZATION COMMAND 


Command Syntax 


AUTHORIZE. Susercode> eSoss<6--<S-sseseSsesieesSseseceeesess > 


>- FOR ------- ATTRIBUTEENTRY -------- 


- MODECHANGE ---- 


- CONFIGURATION - 


- OPERATION ----- 
- INQUIRY ------- 


Semantics 


This command authorizes a user (usercode) to enter certain classes of Operations 
Interface commands, or removes’ that authority. The agent which grants. or 
removes the specified authorization must possess that authority itself. 

If <host-name> is not specified, the local host is assumed. 


This command overrides the effect of any previous authorize command. It takes 
immediate effect, whether or not the user is attached as an agent. 
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Access Control Commands s—“CsCsSCSCSCSCSCSCSCAUTHORIZE 


Servicing Phase 


This command can .be entered at any time during Network mode. 


Default Value 


This command is optional; the default value for any usercode is INQUIRY. There 
are two exceptions to this: (1) at least one agent (for example, the BNA system 
supervisor) has the authority of ALL, and (2) the initialization file agent (if 
this agent posseses a different usercode from the system operator) also has_ the 
authority of ALL. 


Examples 


AUTHORIZE CONTROLUSER FOR ATTR, CONFIG, OPER, INQ 


Command Response Syntax 


<usercode> AUTHORIZED FOR <option as specified in command> 
Inquiry Response Syntax 


=> AUTHORITY FOR <usercode> =<<<sscoSe senna ecsnrcerat esses > 


a ATTRIBUTEENTRY ------ | 


- MODECHANGE ---- 


- CONFIGURATION - 


|= OPERATION ----- 


- MANUAL -------- 


- INQUIRY ~------ 


- SERVICE ------- 
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Section 3 
Access Control Commands 


VALIDATE 


Error Messages 


INVALID AUTHORIZATION OPTION 
- if option is other than those specified in command syntax. 


INVALID USERCODE 
- if usercode does not exist. 


AUTHORITY CANNOT BE GRANTED OR REMOVED 
- if user entering command specifies an authority it does not possess. 


VALIDATE COMMAND 


Command Syntax 


VALIDALE “S222 = saree se hese SSeS eente ese Sse eee eas 
_ Se eees HOS) Sees t eee sare > 

= NE 1 GHBOR mas nina paca = 

HOST, NEIGHBOR ---~ 

SMigNE Saeseeee doses 

eer essere: 
Semantics 


This command supercedes any previous VALIDATE command. 


This command sets the validate options in the various’ levels. lf HOST is 
specified, the initiation of communications with any other host occurs only if 
the name of that host appears as a valid remote host. 


If NEIGHBOR is specified, each neighbor must be validated before a station call 
with that neighbor can succeed. (If NEIGHBOR VALIDATION is false, validation 
can still occur on an individual neighbor when the appropriate connection 
information is supplied; refer to ADD CONNECTION command.) 


If ALL is specified, the combination of HOST and NEIGHBOR validation is used, 


plus validation at the Router level. If Router validate is true, only” those 
nodes which are known to the Router are accepted. 
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Access Control Commands VALIDATE 


This command sets the VALIDATE attribute in the level managers as follows: 


Port Station 
Command option level Router level 
VALIDATE = NONE F F F 
VALIDATE = NEIGHBOR F F T 
VALIDATE = HOST T F F (T = TRUE, 
VALIDATE = HOST, NEIGHBOR T F T F = FALSE) 
VALIDATE = ALL T T T 
NOTE 


It is not possible to set the Router validate to true 
without also setting those of the Port and Station 
Levels. 


Servicing Phase 


These can be entered only during the Network Mode Attribute Entry phase. 


Default Value 


This command is optional. The default value is NONE. 


Examples 


VALIDATE = ALL 
VAL = HOST, NE! 


Response Syntax 


VALIDATE = --- NONE---------------------------------- 


Error Messages 


VALIDATE OPTION INVALID 
- if command options are other than those specified. 
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MAX PROGRAM AGENTS ee ae Section 3 


PROGRAMAGENTSECURITY Control Commands Access Control Commands 


PROGRAM AGENT CONTROL COMMANDS 


The following commands control the Program Agent access to the Operations 
Interface of a local node. 


NOTE 
Later revisions of this manual will provide’ additional 


information concerned with the operation and control of 
these agents. 


Command Syntax 


<integer> range: O to 65535 


PROGRAMAGENTSECURITY ------------------------------------- 


- GUARDEDBY <file-title>- 


These commands set the maximum number of Program Agents which can be connected 
during the operating phase of the node, and the type of security to be used. 


To initiate communications with a Program Agent, refer to the PROGRAM command. 


Servicing Phase 

These commands can be entered only when the node is initializing to or operating 
in Network mode, and when there are no connected Program Agents (that is, there 
are no Subports open for the Operations Interface Handler Port). 

Default Value 

These commands are optional. The default value for MAX PROGRAM AGENTS is zero, 


which means that no Program Agents can be connected. The default for PROGRAM 
AGENT SECURITY is PRIVATE. 
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Section 3 
Access Control Commands Program Agent Control Commands PROGRAM 


Examples 


MAXPROG = 2 
PROGSEC = GUARDED BNA/GUARDF ILE 


Response Syntax 


MAXPROGRAMAGENTS = <integer> 
PROGRAMAGENTSECURITY = --- PRIVATE ------~------------- 
- PUBLIC 9 --------------- 


- GUARDEDBY <file-title> - 


Error Messages 


INVALID MAX PROGRAM AGENT VALUE 
- if integer outside allowable range. 


INVALID PROGRAM AGENT SECURITY OPTION 
- if option is other than that specified in command syntax. 


PROGRAM AGENT ASSOCIATE COMMAND 


Command Syntax 


PROGRAM won nnn nen nnn nnn nnn nnn nbn nnn nnn nn nnn nnn nn ne ene 


So a em se ee <agent~name> Se ee ee SSE Oe ee 0 Sm Re Se oe eee een” 


~ + --- <agent-name> = <prog-agent-specif.> 7 


where <program-agent~specif.> is: 


|. TANY Seer sesr | . AT -~- <your-host> - 


— ow “= 


. KANY ~------- 


|. » USERCODE = <usercode>- 
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Program Agent Control Commands Access Control Commands 


PROGRAM 


Semantics 


These commands establish or break communications with a Program Agent. PROGRAM 
is an operational command, and as such, it can only be entered during the 
operating phase. 


The PROGRAM + command: 


This command initiates communication with a Program Agent. The <agent- 
name> is'a name used to specify an Operations Interface subport used. for 
this purpose. 


The <your-name> is the YOUR NAME value of the Operations Interface 
Handler's specified subport. If *ANY is used, the Operations’ Interface 
subport connects to any Program Agent's MY NAME. 


The <your-host> is the value of the subport YOUR HOST. If AT <your-host> 
is omitted, the local host is assumed. If *ANY is used, any host will be 
accepted. 


The <usercode> is the YOUR USERCODE attribute value of the _ specified 
Handler's subport. If the Program Agent security is PUBLIC or GUARDED, the 
usercode must not be specified. If the security is private the usercode 
can be specified; if it is not, the usercode of the agent entering this 
command is assumed. 


The PROGRAM - command: 
This command breaks the communication with the Program Agent. The subport 
corresponding to the <agent-name> is closed abruptly. 
Servicing Phase 
Program Agents can be associated (connected) only during the operating phase of 
Network mode. Should the node return to Isolated mode, associations with al} 


Program Agents are broken. 


PROGRAM AGENT SECURITY and MAXPROGRAMAGENTS commands control the accessibility 
and visibility (that is, security requirements) of the Program Agents. 


Section 3 
Access Control Commands Program Agent Control Commands 


Examples 


PROG + CONTROLLER = BNASUPERVISOR, UC = SITE 
PROG + CONFIGINFO = *ANY AT MAINHOST 
PROG - CONFIGINFO 


Command Response Syntax 


<agent-name> ASSOCIATED AS PROGRAM AGENT 


<agent-name> DISASSOCIATED AS PROGRAM AGENT 


Inquiry Response Syntax 


Error Messages 


INVALID REMOTE HOST 


PROGRAM 


- if <your-host> is specified and not valid (either because HOST VALIDATE is 


true and the host is not in the valid list, or 
unreachable). 


NO SUCH HOST 
NO SUCH USERCODE 
USERCODE MAY NOT BE SPECIFIED 


- if GUARDED or PUBLIC security applies. 


DUPLICATE AGENT NAME 


host is 


LOCAL IDENTITY 


SECTION 4 
ATTRIBUTE ENTRY COMMANDS 


Attribute Entry commands set single-valued attributes in the Network Services 
managers. The syntax for these commands include both the Attribute Entry and 
the Inquiry forms: 


== <attribute name> S-s-ssSsees-ro ete ese e Skee css eSe ess >| 
-- <set-attribute-specification> - 


When the attribute name alone is entered, it is an Inquiry command; otherwise it 
is an Attribute Entry Command. 


Empty strings can be entered explicitly by using *NULL in place of <value>. 
Empty strings are displayed in responses and reports in this way. 


If *DEFAULT is used in place of <value>, the default value is selected. This is 


particularly useful after initialization to return the attribute to the default 
value. 


LOCAL IDENTITY COMMAND 


Command Syntax 


LOCALIDENTLLY =A32$=-<-<s2- se seeeesnSe ese ee neesese see See ase es 

--~ #<node-address> -------------- 

--- <host-name> #<node-address> -- 

<node-address> range: 1 to MAX NODE ADDRESS 
or less than 65534 

Semantics and Mode Serviced 
lf <node-address> is specified, this command sets the node address of the local 
node. If <host-name> is specified, the host name of the local node is compared 
with this host name (entered by HN command), and a negative response is returned 


if they are different. 


The <node-address> is required to be entered during the Network mode Attribute 
Entry phase; it cannot be entered at any other time. 
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Section 4 
LOCAL IDENTITY | tribute Entry Commands 


Default Value 


There is no default value. This MUST BE ENTERED. 


Examples 


LOCALIDENTITY = #12 
LOC = CENTER #12 


Response Syntax 


LOCALIDENTITY = <host-name> ------------------------ | 


-~ #<node-address> - 


NOTE 
The node address is omitted if it has not yet been set 
during the attribute entry phase. 


Error Messages 


INVALID NODE ADDRESS 


- if the <node-address> value exceeds the range 1 to 65534, or is greater 
than MAX NODE ADDRESS, if one is specified. 


HOST NAME DOES NOT MATCH 


- if <host-name> is entered and it does not match the current <host-name> 
value. 
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Section 4 PORTLEVELINCARNATION 
Attribute Entry Commands Get-Only Attributes 


GET-ONLY ATTRIBUTE COMMANDS 


Get-only attributes are not settable through the Operations Interface. Some of 
them are computed (based on other attribute values), or set externally to 
Network Services operations. 


As these commands are inquiries only, the format is simplified to the command 
syntax followed by the response and any comments. 


PORTLEVELINCARNATION -------------------------------------- | 


This command displays the current value for the Port Level Incarnation 
attribute. 


PORTLEVELINCARNATION is updated at every initialization of the Port Level 
and every time Network mode is entered. 


Response Syntax 


PORTLEVELINCARNATION = <string> 


ROUTERHEADERS Ze “Coss ooaere tae satanes st oreteStarsrr rst ooes | 


This displays the size of the Router header in bytes. 


Response Syntax 


ROUTERHEADERS | ZE = <integer> (bytes) 
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TRANSITCOUNTLIMIT Section 4 
VERSION Get-Only Attributes Attribute Entry Commands 


TRANSITCOUNTLIMIT ------------------------------- 2-22 eee | 


This displays the maximunn value allowed for the Router frame field, TCNT 
(transit count). 


Response Syntax 


TRANSITCOUNTLIMIT = <integer> 


VERSION -----0 2 n-ne nnn nn nnn nnn nnn nnn ne nn enn nnn ene n enn e eee | 


= oo 


This displays the version identifications for the various BNA Network 
Services levels. 


Response Syntax 


VERSION FOR ---- NETWORK ---- @ <string> ------------- | 


# Noh -ss<5s<< = SStr ings: sss =+s-s= 


PORTLEVEL -- = (<level-version>) - 


ROUTER ----- = (<level-version>) - 


STATIONLEVEL = (<level-version>) - 


where <level-version> is: 


“- <string> : <integer> COMPATIBLE WITH ~-- <integer> ---| 
notes: 


. The <string> is the level version identifier. 

. The <integer>s are the level version protocols. 

. In Isolated mode, only Network Services Manager (NSM) 
and Port Level Manager (PLM) versions are returned. 
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Section 4 NETWORKMAXSEGMENTSIZE 
Attribute Entry Commands NETWORKVERSION 


NETWORK ORIENTED COMMANDS 


Command Syntax 


NETWORKMAXSEGMENTSIZE --------------------------------------- 


- = <jnteger> -- 


<integer> range: 60 to 65535 


- = <string> -- 


<string> range: 1 to 17 significant characters 


Semantics 


These commands set the NETWORK VERSION and the NETWORK MAX SEGMENT SIZE. The 
NETWORK VERSION can be used by the network administration to coordinate changes 
in network configurations; the NETWORK VERSION must be identical for all 
communicating nodes. 


The NETWORK MAX SEGMENT SIZE is the MAX SEGMENT SIZE used for all communications 
in the network (with the possible exception of link connections between two 
consenting neighbors) . 
The segment size is the number of bytes used by a Router’ frame. This is 
the Router header plus any port frame characters. It is the size of the 


message that is sent from a node, excluding any Station Level header’ or 
trailer characters. 


Servicing Phase 


These can be entered only during the Attribute Entry phase. 


4:5 


NETWORKMAXSEGMENTSIZE Section 4 
NETWORKVERSION Attribute Entry Commands 


Default Value 
These commands are optional, with default values: 


NETWORK VERSION = *NULL (the empty string) 
NETWORK MAX SEGMENT SIZE = 128 bytes 


Examples 


NETWORKVERS!ION = BNA-JA 
NWMSS = 256 


Response Syntax 
NETWORKVERSION = <string> 


NETWORKMAXSEGMENTSIZE = <integer> 


Error Messages 


INVALID NETWORK MAX SEGMENT SIZE 
- if <integer> exceeds allowable range of values. 
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Attribute Entry Commands Logging and Monitoring Commands LOGGING 


LOGGING AND MONITORING COMMANDS 


These commands control the options that are available for logging node activity 
and for setting certain resource monitors within a node. 


LOGGING OPTION COMMAND 


Command Syntax 


LOGGING -------------------------------------------- 


-- MINIMUM ---- 


~~ MAXIMUM ---- 


Semantics 


This command sets the logging option for the local node. 


Command form: Option set: 
LOGGING - NONE 
LOGGING + STANDARD 
LOGGING + MAXIMUM MAX | MUM 
LOGGING + MINIMUM MINIMUM 
NOTE 
For further detail, refer to Volume 1 of the reference 
manual. 


Servicing Phase 


« 


This command can be entered at any time in Network mode. 
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LOGGING . Logging and Monitoring Commands 


Default Value 

This command is optional; the default value is STANDARD. 
Examples 

LOGGING + MINIMUM 


LOG + 


Response Syntax 


LOGGING = ----- ailllcsiatetehtataiatataiatatataataietenetsatabaetaaianene 


- MINIMUM --- 
- MAXIMUM --- 
where + alone indicates standard logging, 
and - indicates no logging. 
Error Messages 


INVALID LOGGING OPTION 


- if option specified is other than MINIMUM or MAXIMUM. 
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Section 4 
Attribute Entry Commands 


Section 4 
Attribute Entry Commands Logging and Monitoring Commands MONITOR 


MONITOR TRAFFIC COMMAND 


Command Syntax 


MONITOR wrest tt mete reenter nme nnn eee en ne ees ee ne nene 
Seseiat: , ooterceee 
eee eee eee 
em<: TRAFFIC =s= 
oes) COP) cee rees 
= INTERVAL ---==-==s<ss<e<= = <time-interval> - 
- TRAFFIC - 
- STATION - 
<time-interval> range: 1 to 60 mins. 
Semantics 


This command sets the monitor or monitor interval for selected activities, and 
supercedes any previous such command. 


MONITOR + or - form: 


If the monitor is turned on (MONITOR +) and TRAFFIC ONLY is specified, a 
summary of all traffic passing through the Router is recorded in the log. 
If COPY ONLY is specified, a copy of each Router frame is logged. If 
MONITOR + is unqualified, both items are recorded in the log. 


The command MONITOR - resets the monitor for both the TRAFFIC and COPY 
options. 


This command cannot turn on or turn off the Station Monitors. These 


monitors are accessed by setting a station MONITOR attribute using the ADD 
STATION or MODIFY STATION command. 
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Section 4 


MONITOR Logging and Monitoring Commands Attribute Entry Commands 


MONITOR INTERVAL form: 


The MONITOR INTERVAL form of the command sets the monitor time interval, 
either for Router traffic (TRAFFIC specified), or for station monitors 
(STATION specified), or for both (the unqualified MONITOR INTERVAL form). 


This time interval is used to trigger the recording of monitor information 
in the Router, if the TRAFFIC monitor has been turned on, or in any station 
where the monitor attribute has been set to TRUE. 


Servicing Phase 


These commands can be entered at any time while in Network mode. 


Default Value 


This command is optional. The default value for the MONITOR is OFF, and the 
default value for INTERVAL is 15 minutes. 


Examples 


MON + 

MONITOR + TRAFFICONLY 
MON - 

MONITOR INTERVAL = 45:0 
MON INT STA = 30:0 


Response Syntax 


MONITORS --- + --------------------------------------- > 
-~----- TRAFFIC ------ 
a------ COPY -------- 
SSeS ea Pee ee I ee ee | 
>- INTERVAL FOR ----- TRAFFIC = <time-interval> ----- | 


|. STATION = <time-interval> | 
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Section 4 PORTLOGINTERVAL 


Attribute Entry Commands Logging and Monitoring Commands 


Error Messages 


INVALID MONITOR OPTION 
- if other than the specified options are entered with this command. 


INVALID MONITOR TIME INTERVAL 


- if time interval is outside allowable range. 


PORT LOG INTERVAL COMMAND” 


Command Syntax 


PORTLOGINTERVAL -------------------------------------------- | 


- = --- <time-interval> -- 


<time-interval> range: 1 to 1440 minutes (1 day) 


Semantics 


This command sets the time interval which starts the recording of certain 
resource usage information in the Port Level. 


Servicing Phase 


This command can be entered at any time. 


Default Value 


This command is optional. The default value is 60 minutes. 
Examples. 

PORTLOGINTERVAL = 120:0 

PLI = 6:0:0 


Response Syntax 


PORTLOGINTERVAL = -- <time-interval> ---------- 


MAXHOPCOUNT Section 4 
MAXRESISTANCEFACTOR Tuning Attribute Commands Attribute Entry Commands 


Error Messages 


INVALID PORT LOG TIME INTERVAL 
- if time interval is outside allowable range. 


TUNING ATTRIBUTE COMMANDS 


Tuning commands are used to optimize network performance by adjusting attributes 
in the Network Services levels: Port, Router, and Station. 


Although all of these tuning attributes are accessible to a network Operations 
Interface agent, they should not be adjusted without regard to their effects. In 
particular, the attributes PORTSEGMENTT!MEOUT and PORTWINDOWSIZE have calculated 
default values, and rely upon MAXRESISTANCEFACTOR and MAXHOPCOUNT as input to 
the calculation. Careful consideration of the effects of changing these should 
be made, as indiscriminate changes can adversely affect network performance. 


In the following paragraphs the attributes are described, and where caution is 
needed, notes and guidelines are provided. 


NOTE 
The format for this subsection is slightly different. 


The commands are all mentioned as a group and are then 
followed by responses, defaults, errors, and so on. 


ROUTING ORIENTED COMMANDS 


These commands set the routing-oriented tuning attributes. 
Command Syntax 


NAAROPCOUNT “Reraree aS veesoea Se se Seater ese losses s eres e aes 
= S Se=-<integer> 2ssee<- 


<integer> range: 1 to 255 


See MAXRESISTANCEFACTOR for explanation. 


MAXRESISTANCEFACTOR -------------------9-------------------- 


- = ==" SUN tegers-=S-=-4 <5 


<integer> range: 1 to 65535 
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Section 4 NEIGHBORRESTARTTIMEOUT 


Attribute Entry Commands Tuning Attribute Commands NODERESISTANCEFACTOR 


The attributes MAXRESISTANCEFACTOR and MAXHOPCOUNT specify the bounds of 
the reachable nodes. That is, the BIAS ® mechanism considers each pathto a 
node, and limits its search when either of these attribute values is 
reached. Paths to nodes that equal or exceed these limits are considered 


unusable, and nodes that are only accessible by paths that equal or exceed 
these limits are unreachable. 


The hopcount should be kept as small] as possible but still allow all reasonable 
routings. 
The maximum resistance should be made large enough to allow all reasonable 
routings. 

NOTE 


Both MAX HOP COUNT and MAX RESISTANCE FACTOR values must 
be made |] more than the maximum values calculated for 


resistance and the number of hops to be used across’ the 
network. 


For further detail on the selection of these values, refer to Appendix B. 


NEIGHBORRESTARTTIMEQUT --~----------------------------------- | 


- © --- <time-interval> -- 


<time-interval> range: 0 to 1200 tenths-~of-seconds 
| (2 minutes). 


This timeout value is used whenever a NEIGHBOR-RESTART command is received. 


While this timer runs, the Router does not send NETCHANGES about its 
neighbor. 


This attribute specifies the time that a node waits, after a neighbor has_ been 


recognized as restarting, before it informs other nodes of the restarting 
neighbor's view of the network. The default value should not need adjustment. 


NODERESISTANCEFACTOR Bee oe ee eae Pen eee ee | 
oe ; = moses Si Rleger> ser=<s== 
<integer> range: 1 to 65535 
This is the resistance factor of the local node, and is the average time, 
in milliseconds, for a message to transit the node in the absence of any 


other traffic. It is used by other nodes for choosing routings. 


This attribute can be increased to make it a less desirable transit path by 
other nodes. It can be decreased to make it more desirable. 


® BIAS is a trademark of Burroughs Corporation. 
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Section 4 


NODEUPTIMEOUT Tuning Attribute Commands Attribute Entry Commands 
NODEVPTIMNEQUT ‘See cr race mses ese ae rere ss teers sea tSSs nase 
- = --- <time-interval> -- 


<time-interval> range 0 to 600 tenths-of-seconds 
(1 minute) 


When a node first comes up, no NETCHANGE messages are sent out until a 
timeout period of NODEUPTIMEOUT occurs with mo LINKCHANGE or NETCHANGE 
messages received. 


This attribute is used to prevent an unnecessary number of netchange messages 
from being sent by this node after it enters the network, either initially = or 
during recovery. The node should wait until all netchange messages are received 
(and analized) before sending netchanges to its neighbors. 


The default time value should not require adjustment. 


Servicing Phase 
The NODE RESISTANCE FACTOR, NODE UP TIMEOUT, and NEIGHBOR RESTART TIMEOUT 


attributes can be set at any time while in Network mode. The others can be 
entered only during the Network mode Attribute Entry phase. 


Default Value 


MAX RESISTANCE FACTOR 5000 (these are arbitrary values, they 
MAX HOP COUNT = 5 should be changed to reflect the 
network needs) 


NODE UP TIMEOUT = 5.0 (seconds) 
NEIGHBOR RESTART TIMEOUT 10.0 (seconds) 


NODE RESISTANCE FACTOR varies with system type: 


B1000 type system = 150 


B4800 type system = 70 
B6800 type system = 30 
B7800 type system = 10 
Examples 
MRF = 7500 


NODEUPTIMEOUT = 7.5 
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Response Syntax 


|--- <attribute-name> -- = --- <integer> ---------- | 


- <time-interval> -- 


for example, NEIGHBORRESTARTTIMEOQUT = 1:5.5 


Error Messages 


INVALID MAX RESISTANCE FACTOR 
- if integer is outside of the allowable range. 


INVALID MAX HOP COUNT 
- if integer is outside of the allowable range. 


INVALID NODE RESISTANCE FACTOR 
- if integer is outside of the allowable range. 


INVALID NODE UP TIMEOUT VALUE 
- if time interval is outside of the allowable range. 


INVALID NEIGHBOR RESTART TIMEOUT VALUE 
- if time interval is outside of the allowable range. 


4-15 


Section 4 
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LINK RESISTANCE TO NEIGHBOR COMMAND 


LINKRESISTANCE --+ <neighbor> = --- <jinteger> ---------- | 


~- *DEFAULT -- 


<integer> range: 1 to MAXRESISTANCEFACTOR 


Semantics 


This command sets the link resistance factor for the link to the specified 
neighbor in the Router Neighbor Table. It is the average time, in 
milliseconds, for a message to transit the link. 


lf this value is set to an integer greater than zero, it overrides’ the 
calculated default value of link resistance. 


This value is used by the Router in choosing routings. The default value should 
not need adjustment except for altering the desirability of using a link. For 
example, there may be a case where the link to a neighbor is required for 
communication to that neighbor, but it is not required to be used for traffic to 
transit this node. In this case, if the link resistance is increased, it still 
exists for the neighbor, but other nodes will find that the total link 
resistance is higher than MAXRESISTANCEFACTOR, or higher than an alternate path. 
Thus, only the neighbor will use the link. 


Default Value 


lf the value is *DEFAULT, the default value is calculated by the _ following 
equation: 


1000 X maxsegsize X 8 
default Tink. Feéststance ®: esr s=Sesss<SsSosss=ss<<=+ 
summation (speed X eff/100) 


NOTE 
Where speed and eff are the Station Level attributes 
SPEED and EFFICIENCY for the individual links. The 
summation is used where there are multiple-parallel 
links. 
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Examples 


LINKRESISTANCE REMOTE-1 = 2000 
LR REMOTE-2 = 4567 


Response Syntax 


LINK RESISTANCE CHANGED WITH <neighbor> 


Error Messages 


INVALID LINK RESISTANCE FACTOR 
- if integer is outside allowable range. 


SUBPORT COMMUNICATION COMMANDS 


Subport Communication commands are used to set tuning attribute values for 
subport communication. Changing these attributes only affect new subports, 
existing subport attributes remain unaffected. 


Command Syntax 


PORTCOMPRESSIONALLOWED ---------------------------- 


-— + ae 


When set, +, this allows the subports to use data compression. Compression 
is only invoked if both subports request it. 
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PORTRESUMEREADY 


PORTRETRYLIMIT 
PORTSEGMENTTIMEOUT Section 4 
PORTWINDOWSIZE Tuning Attribute Commands Attribute Entry Commands 


PORTRESUMEREADY ~--------------------------- 2-2-2 eee ee 
> msn = <integer>  =S<-s<s- 
<integer> range: 1 to 99 (per cent) 


PORTRESUMEREADY regulates the level at which the MESSAGE FORWARDING QUEUE 
changes from NOT READY to READY; that is, the queue becomes not ready when 
full but only goes ready again when PORTRESUMEREADY queue level is reached. 
This is used to reduce unnecessary changes of ready status in those 
subports communicating with "remote'' subports. 


PORTRETRYLIMIT ------------------------ 0 -------------------- 


= moses <A tegero: Hees s== 
<integer> range: O to 100 


This attribute specifies the number of times to retransmit any particular 
unacknowledged subport segment before disconnecting the dialogue. 


PORTSEGMENTTIMEQUT cnn nnn rrr mn mtr nr nr rrr nen nner nena | 
- = --- <time-interval> -- 
<time-interval> range: 0 to 65535 secs. 


This subport attribute specifies the waiting time for acknowledgement of 


any particular subport segment before attempting to retransmit it or report 
an error. 


The segment timeout is intended to recognize that subport frames are lost, 
probably due to an intransit node failure, or closure. This attribute has a 
calculated default value and SHOULD NOT be changed without CAREFUL CONSIDERATION 
of the effect. If changed, the value should NOT be made too SMALL. If it is 
made too small it can cause excessive retransmissions in the network when the 
network load is at a peak, and transit times are at a maximum. 


PORTWINDOWSIZE ~----------------------- = 0-22 ono 


- = --- <integer> -------- 


<integer> range: 1 to 60 


This attribute indicates the number of segments that subports can send (and 
the number jit can expect to receive) that are unacknowledged. The value 
applies to traffic in both directions. The actual value used for a 
dialogue is determined during subport attachment and if they are unequal, 
the smallest value of PORTWINDOWSIZE of the two ports is used. 
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PORTRESUMEREADY 


PORTRETRYLIMIT 
Section 4 PORTSEGMENTTIMEOUT 
Attribute Entry Commands Tuning Attribute Commands PORTWINDOWSIZE 


PORTWINDOWSIZE has a calculated default value and SHOULD NOT be changed without 
CAREFUL CONSIDERATION to the effect. If changed, the value should NOT be made 
too LARGE, as this can lead to overload of the network. The network peak load 
is, in fact, a function of the summation of all window sizes used within’ the 
network. Exceeding the peak load capability of any part of the network = can 
cause extra retransmissions, thus degrading the network performance. 


Servicing Phase 


These commands can be entered only in Network mode. 


Default Value 


The following attributes, if not explicitly set during the Attribute Entry phase 
of node initialization, have default values computed as follows: 


PORT WINDOW SIZE = 4 x MAX HOP COUNT 


PORT SEGMENT TIMEOUT = PORT WINDOW SIZE X MAX RESISTANCE FACTOR 
divided by 1000 and rounded up to an integer 


The values of MAX HOP COUNT and MAX RESISTANCE FACTOR used in the calculations 
are the values which exist at the end of the node initialization. 


These attributes have the following default values; the set commands are 
optional: 


PORT RETRY LIMIT 
PORT RESUME READY 
PORT COMPRESSION ALLOWED 


2 
60 (percent) 
- (off) 


Examples 


PORTSEGMENTTIMEOUT = 10 
PWS = 5 
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PORTRESUMEREADY 


PORTRETRYLIMIT 
PORTSEGMENTTIMEOUT Section 4 
PORTWINDOWSIZE Tuning Attribute Commands Attribute Entry Commands 


Response Syntax 


[#= <attribute-name> --- = -=-- <integer> --------- | 


- <time-interval> - 


For example: PORTWINDOWSIZE xe (5 


NOTE 
Inquiries about values of calculated attributes return 
*UNKNOWN if they have not yet been determined. 


Error Messages 


INVALID PORT SEGMENT TIMEOUT INTERVAL 
- if time interval is outside allowable range. 


INVALID PORT WINDOW SIZE 
- if integer is outside of allowable range. 


INVALID PORT RETRY LIMIT 
- if integer is outside of allowable range. 


INVALID PORT RESUME READY FACTOR 
- if integer is outside of allowable range. 


INVALID PORT COMPRESSION ALLOWED OPTION 
~ if value is other than + or -. 
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Section 4 


HOSTINACTIVEDISCONNECT 
Attribute Entry Commands 


Tuning Attribute Commands HOSTINACTIVETIMEOUT 


INTER-HOST COMMUNICATION COMMANDS 


The following commands set. the 


tuning attributes used in 
communications control. 


host-to-host 


Command Syntax 


HOSTINACTI VEDI SCONNECT 


This attribute, if + (true), indicates that a PLM-to-PLM dialogue is to be 
terminated automatically if, for a continupus time interval determined by 
the HOST INACTIVE TIMEOUT attribute, there is no subport allocated for use 
with the associated remote host on behalf of any using process. 


HOST!INACTIVETIMEOUT 


- = --- <time-interval> -- 
<time-interval> range 0 to 1440 minutes (1 day) 


This attribute is the amount of time a PLM-to-PLM dialogue is maintained 
without any subports allocated for use with a given host (this does not 
include the PLM-to-PLM subports). It is only meaningful when the HOST 
INACTIVE DISCONNECT is + (true). 
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HOSTINACTIVETIMEOUT 
HOSTINACTIVEDISCONNECT Tuning Section 4 
HOSTUNREACHABLETIMEOUT Attribute Commands Attribute Entry Commands 


i Nene Setter tte it 


HOSTUNREACHABLETIMEQUT seer nnn nnn nnn n nnn mene rer nnn nnn nme nn n- 
: ; : : - = <time-interval> ---- 
<time-interval> range 0 to 1440 minutes (1 day) 
This sets the time period that the local host waits while a remote host is 


unreachable before terminating all port level communications with that 
host. 


Servicing Phase 


These commands can be entered at any time while in Network mode. 


Default Value 


These commands are optional. The default values are: 


HOST INACTIVE DISCONNECT = - (false) 
HOST INACTIVE TIMEOUT = 10:0 (10 minutes) 
HOST UNREACHABLE TIMEOUT = 30:0 (30 minutes) 


Examples 


HOSTINACTIVED!ISCONNECT = 20:0 
HID = - 
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Section 4 Tuning HOSTUNREACHABLETIMEOUT 
Attribute Entry Commands Attribute Commands HOSTINACTIVE DISCONNECT 


Response Syntax 


|--- <attribute-name> --- = --- <integer> --------- | 


- <time-interval> - 


NOTE 
Inquiries about values of calculated attributes return 
*UNKNOWN if they have not yet been determined. 


Response Syntax Examples 


HOSTINACTIVEDISCONNECT = + 
HOSTUNREACHABLETIMEOUT = 10:0 


Error Messages 


INVALID HOST INACTIVE DISCONNECT OPTION 
- if option is other than TRUE/FALSE. 


INVALID HOST !tNACTIVE TIMEOUT 
- if time interval is outside allowable range. 


INVALID HOST UNREACHABLE TIMEOUT 
- if time interval is outside allowable range. 
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i a 


STATION-ORIENTED COMMANDS 


Command Syntax 


NEIGHBORBUSYTIMEQUT -------------------~------------------- | 


wc- m= --<time-interval>------ 


<time-interval> range: 0 to 3000 tenths of seconds 


(5 mins) 
This command sets the time period that ALL links to a neighbor must be busy 
before a NEIGHBOR STATUS REPORT is generated. Neighbors are only reported 
as being busy if the station attribute REMOTEBUSYMONITOR is set. 
NE|GHBORGREETINGT!IMEOUT --------------- SiS eS Sie i oes Seals ow one oie | 


“-- = -- <time-interval> -- 


<time-interval> range: 0 to 600 tenths-of-seconds 
(1 minute) 


This command sets the timeout value for the Station Level Greetings. It is 
used to set a maximum time period within which the validation process must 
be accomplished. 


Servicing Phase 


These commands can be entered at any time during Network Mode. 


Default Value 


NE!GHBOR GREETING TIMEOUT = 30.0 seconds. 
NEIGHBOR BUSY TIMEOUT = 60.0 seconds. 


Both attributes are optional, and default if not explicitly set. 


Examples 


NE|GHBORGREETINGTIMEOUT = 45 
NGTO = 27.5 


NEIGHBORBUSYTIMEOUT = 2:0.0 
NBTO = 2000 
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Response Syntax 


NEIGHBORGREETINGTIMEOQUT = <time-interval> 


NEIGHBORBUSYTIMEOUT = <time-interval> 


Error Messages 


INVALID NEIGHBOR GREETING TIMEOUT VALUE 
- if time interval is outside of the allowable range. 


INVALID NEIGHBOR BUSY TIMEOUT VALUE 
~ if time interval is outside of the allowable range. 


TUNINGS INQUIRY COMMAND 


The Tunings inquiry command inquires of the state of all tuning attributes for a 
node, and responds with a list of all of the attribute settings. 


Response Syntax 


All of the TUNING attributes (described in this subsection) 
are listed together with their values or settings. Attributes 
included are: 


HOST INACTIVE DISCONNECT, HOST INACTIVE TIMEOUT 
HOST UNREACHABLE TIMEOUT, LINK RESISTANCE 

MAX HOP COUNT, MAX RESISTANCE FACTOR 

NE!GHBOR BUSY TIMEOUT, NEIGHBOR RESTART TIMEOUT 
NEIGHBOR GREETING TIMEOUT 

NODE RESISTANCE FACTOR, NODE UP TIMEOUT 

PORT COMPRESSION ALLOWED, PORT RESUME READY 
PORT RETRY LIMIT, PORT SEGMENT TIMEOUT 

PORT WINDOW SIZE 
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NODESUMMARY Section 4 


Tuning Attribute Commands Attribute Entry Commands 


ATTRIBUTE SUMMARY 


All of the attribute settings and values for the node may be obtained with the 
NODESUMMARY inquiry. 


Response Syntax 


All attributes and their settings or values are displayed as a list. 


Servicing Phase 


This can only be entered in Network mode. 


NOTE 
The Candidate Summary and the Mode information are also 
applicable in |solated mode, but these must be explicitly 
‘requested using the CANDIDATE and NET inquiry commands, 
respectively. 
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SECTION 5 
CONFIGURATIONAL COMMANDS 


The configurational] commands generate and change the node's network 
configuration information. They are operationally inert; that is, they neither 
create nor destroy communication paths. They simply change the potential for 
what paths can be created. 


For example, ADD STATION or ADD CONNECTION does not create a new link to a 
neighbor; rather it sets up the information by which a link can be later created 
with an operational command such as ESTABLISH CALL. Similarly, DELETE STATION 
does not sever a link; the station must already be disconnected in order’ to be 
deleted. 


In the DELETE commands, if both <host-name> and <node-address> are specified, 
the correspondence of the two is checked before the delete takes place. 


Unless otherwise specified, all configurational commands can be entered only 
during the Initialization or Operating phases of Network mode. The first 
Configurational command entered during node initialization signals the end of 
the Attribute Entry phase. All required attributes must have been entered prior 
to this point. 


In the examples, the symbol => indicates that the positive response to the given 
command follows. 
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CONFIGURATIONAL COMMAND SYMMETRY 


Consider the ADD and DELETE commands for hosts and nodes and the ADD and DELETE 
STATION or CONNECTION commands to be described later. The action of these 
commands possesses a symmetry which is illustrated in figure 5-1. In this 
diagram ''- - -'' implies no effect. 


Port-level Router Station-level 
Effect Effect Effect 
ADD HOST add host add node --- 


DELETE HOST delete host --- --- 


ADD NODE oe add node Sk 
DELETE NODE delete host delete node (must not be 
neighbor) 
ADD CONNECTION - - - (must already add 
WITH NEIGHBOR be a node if connection 
Router VAL true) 
DELETE CONN. - = a es delete 
WITH NEIGHBOR connection 


Figure 5-1. Configurational Command Symmetry 
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NETWORK DEFINITION COMMANDS 


ADD HOST COMMAND 


Command Syntax 


Response Syntax 
<host-name> #<node-addr> ADDED AS HOST 


Semantics 


This command adds the specified host as a remote host. When HOST VALIDATE is 
true, entering this command is required to validate the host host valid. 
Otherwise the only effect is to add the host for the purpose of translating 
between <host-name> and <node-address>. 


lf ROUTER VALIDATE is true (the VALIDATE option was set to ALL), this command 
adds the host as a node to the Router unless the node already exists (by having 
entered previously an ADD NODE command). 


Examples 
ADD HOST BRANCH2 #5 


=> BRANCH2 #5 ADDED AS HOST 


Error Messages 


HOST NAME - NODE ADDRESS DO NOT MATCH 


- if a previous command giving both host-name and node-address was entered 
and this command has a different host-name and node-address pair. 


INVALID NODE ADDRESS 


- if the <node-address> value exceeds the range 1 to 65534, or is greater 
than MAX NODE ADDRESS, if one is specified. 
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bidet deeaates ; Network Definition Commands Configurational Commands" 
ADD NODE COMMAND 

Command Syntax 

ADD NQUE. cae eS eset er SS #<node-address> ------------- 


_ <host-name> - 


Semantics 
If ROUTER VALIDATE is true, this command adds the specified node to the Router 
existence. If, in addition the host name is supplied, the host-name and node- 


address pair information is stored for translation purposes, whether or not 
ROUTER VALIDATE is true. 


Examples 


ADD NODE BRANCH2 #5 


=> BRANCH2 #5 ADDED AS NODE 


Error Messages 


ROUTER VALIDATE |S FALSE, COMMAND HAS NO MEANING 
- if this command specifies only node address and ROUTER VAL is false. 


NODE ALREADY ADDED 
- if node was already added and this command does not specify host-name. 


HOST ALREADY ADDED 
- if host validate is true and host is in the table. 


MISSING NODE ADDRESS 


INVALID NODE ADDRESS 
- if the <node-address> value exceeds the range 1 to 65534, or is greater 
than MAX NODE ADDRESS, if one is specified. 
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DELETE HOST 


DELETE HOST COMMAND 


Command Syntax 


DELETE: HOST .<host=name> sss sssssserreser<seeeeeesHeeSsSeecs 


-- #<node-address> -~ 


<node~address> range: 1 to 65534 
(or MAX NODE ADDRESS if specified) 
Response Syntax 


<host-name> #<node-address> DELETED AS HOST 


Semantics 


This command has meaning only if HOST VALIDATE is true, in which case the 
indicated host is removed as a valid remote host. Whether HOST VALIDATE is true 
or not, the host-name and node-~address pairing information is retained for 
translation purposes. 

A PLM-to-PLM subport to a host that is to be deleted is allowed. However, the 


host is not deleted and an error is returned if there is at least one other 
subport in use to that host. , 


Examples 
DEL HOST BRANCH2 


=> BRANCH2 #5 DELETED AS HOST 


Error Messages 


HOST NOT DELETED, SUBPORTS IN USE: <integer> 


HOST NAME - NODE ADDRESS DO NOT MATCH 
- if this command supplies both and they do not agree with the existing 
host-name and node-address pair information. 


INVALID HOST NAME 
- if host name = local host. 
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INVALID NODE ADDRESS 
- if the <node-address> value exceeds the range 1 to 65534, or is greater 
than MAX NODE ADDRESS, if one is specified. 


DELETE NODE COMMAND 


Command Syntax 


DELETE NODE -S=sSSSesRcere-eheseeS=5 #<node-address> --------- 


~~ <host-name> --| 
<node-address> range: 1 to 65534 
‘(or MAX’ NODE ADDRESS if specified) 


Response Syntax 


- <host-name> - 


Semantics 


This command performs the following functions: (1) it deletes the specified node 
from the Router existence, (2) it deletes the specified node as a host. 


If the Host Validate is false, and the node is still reachable, the PLM (Port 
Level Manager) will attempt to send greetings to establish the identity of the 
remote host. If successful, then the new identity is used for translation 
purposes, else no translation of host/node is possible. 


The node is not deleted and an error is returned if the node is connected as a 


neighbor, or there is at least one subport, not including the PLM subports,. in 
use to that node. 
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Examples 
DELETE NODE #5 


=> BRANCH2 #5 DELETED AS NODE 
Error Messages 
NODE NOT DELETED, NODE 1S CONNECTED AS NEIGHBOR 
NODE NOT DELETED, SUBPORTS IN USE: <integer> 


HOST NAME - NODE ADDRESS DO NOT MATCH 
- if both aré entered and they do not agree with pair information previously 
entered. 


NODE ALREADY DELETED 
- if node does not exist or ROUTER VALIDATE is false, and the node does not 


appear as a remote host. 


INVALID NODE ADDRESS 


INVALID HOST NAME 
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AUTOINIT Station Level Commands Configurational Commands_ 


STATION LEVEL COMMANDS 


These commands enter configurational information for the Station Level. They 
mainly set up the station names and the associated station attributes. In this 
subsection the station attributes are first described followed by the Station 
Level] commands. 


STATION ATTRIBUTES 


Station attributes are set using ADD and MODIFY STATION commands. Also, these 
attributes are used by the ADD PROFILE command to construct a named list of 
attributes for later use by an ADD STATION. The attribute descriptions are 
organized under several categories, and within each category they are in 
alphabetic order. At the end of the attribute descriptions there is a list, 
figure 5-2, of BDLC Station Level attributes, showing default values and the use 
of the attribute. 


Station-Level-Manager Attributes 


AUTOINIT = TRUE or FALSE optional, default = TRUE 


ot ee oe om ow oe oe - - 


For certain station types AUTOINIT TRUE causes the station to be attached, at 
initialization, to its neighbor station without an explicit Operations Interface 
command. 


EFFICIENCY = <integer> optional, default = 95% for DEDICATED station 
--- = 45% for SWITCHED station 
<integer> range: 1 to 100% 
This is used for determining the default value for the link resistance factor as 


used by the Router. It is used in conjunction with line speed for this 
determination. Efficiency is entered as a percentage (%). 


HARDWARE = <string> required 


It is used to identify the hardware to be used by a station. This is a system- 
dependent attribute; For this, refer to the publication for the specific 
product. : 
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MAX SEGMENT SIZE = <integer> optional, default = NETWORKMAXSEGMENTSIZE 


<integer> range: 60 to 65535 bytes 


The MAX SEGMENT SIZE is the largest link information unit that can be sent by 
the Router to the Station Level. For BDLC links, it is the length of the 
I-Field. 


This attribute must be set at least as large as NETWORKMAXSEGMENTSIZE. For Port 
dialogues that are between hosts that are neighbors, the station MAXSEGMENTSIZE 
is used. For port dialogues that are between hosts that are not neighbors, the 
NETWORKMAXSEGMENTSIZE is used. 


MONITOR = ON or OFF optional, default = OFF 


The setting of this attribute causes the station to accumulate count information 
that is periodically interrogated and logged (refer to MONITOR command). 


SPEED = <integer> required 


This is the line speed (Baud rate). It is used to determine the default link 
resistance factor, as used by the Router. 


Optional Station Attributes 


DATARATESELECTOR = ON or OFF default = OFF 


This attribute causes the data rate selector level to a modem to be high ON, or 
low OFF. 


RETRYLIMITCHECKPT = <jnteger> default = 3 


This attribute sets the retry limit for attempts to obtain checkpoint 
information. This can occur when the P-bit is put on to obtain acknowledgement 
of previous transmissions. If there is no response after the retry limit is 
reached, the BDLC station attempts a link reset (sends SABM). 
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RETRYLIMITSABMDIS = <integer> default = 3 


This attribute sets the retry limit for unacknowledged SABM or DISCONNECT 
transmissions for the BDLC station. SABM retry limit being exceeeded causes the 
station (not permanent type) to attempt a disconnect. If this fails the station 
is closed and the Station Level manager informed. 


SELECTSTANDBY = ON or OFF default = OFF 


This attribute causes the select standby level to a modem to be high ON, or low 
OFF. 


WINDOWS 1 ZE = <integer> default = 7 


<integer> range: 1 to 7 
This attribute is used to determine the number of BDLC !I-frames that can be sent 


before an acknowledgement is received. 


Required Station Attributes 


The following attributes are required for all stations. 


CTSRSPTIMER = <time-interval> 


range: 8.5 to 275 milliseconds 
This attribute describes the time to wait between request-to-send (RTS) to 


receiving clear-to-send (CTS) from the modem. 


DCDOFFDELAYT! MER = <time-interval> 


range: 1 to 60 secs. 
This attribute describes the time to wait during transitions of DCD (data- 


carrier-detect) from the modem. This is set to avoid unnecessarily closing the 
link due to a short hit on the line. 
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DIALRESPONSETIMER = <time interval> 


range: 3.5 to 40.5 secs. 


This attribute is set to allow the system to disconnect the line if for = any 
reason an incoming call does not result in coherent dialogue. This can occur’ if 
a human dials into the system by mistake or otherwise. 


DSRRSPTIMER = <time-interval> 


This attribute describes the time to wait for the data set ready (DSR) modem 
level] to come true. This occurs in several instances, for example, when data 
terminal ready (DTR) goes true and all other conditions are right, DSR should go 
true after some modem-defined time. If this does not occur, then the station is 
closed. 


FRSTIMERSHORT = <time-interval> 


This attribute, 'F' Response Timer Short, is the time allowed to receive an 'F' 
bit response after a 'P' bit has been sent out. If the timer expires, the 
command is retransmitted. ; 


This timer and the FRSPTIMERLONG attribute are used for the same _ functions. 
However, the two values are provided to overcome contention situations of two- 
way-alternate operation. (The timer chosen for the actual function performed 
depends upon the factors of node addresses, and whether it is an input or output 
operation, and is handled internally by the station). 


The timer value should be set long enough that normal communication procedures 
will not cause the timer to time out. Factors to be considered for arriving at a 
value should be: propogation delays (in both directions); any modem turn-around 
delays; the command message and |-Frame message transmission times (functions of 
message length and line speed); and the end-point processing delays. 


FRSPTIMERLONG = <time-interval> 


This attribute, 'F' Response Timer’ Long, has the same function as 
FRSPTIMERSHORT, but should be set 1 second longer. See FRSPTIMERSHORT for 
detail. 


STATION ATTRIBUTES: Section 5 
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CHECKPOINTTIMER = <time interval> 


This attribute describes the time to wait after an I-frame is sent before 
demanding an acknowledgement. This timer is restarted upon each receipt of an I|- 
frame until the last outstanding |I-Frame is received. 


This should be set to a value at least twice as large as FRSPTIMERSHORT. (As 


this timer is used to monitor I-frame transmissions, the time for frame 
transmission may be significant and should not be over looked.) 


Optional Station Event-Monitor Attribute 


CPDMONI TOR = ON or OFF optional, default = OFF 


Setting this attribute ON will cause instances of open or close Connection Port 
Dialog to be logged. 


Optional Station Counter-Monitor Attributes 


The following attributes are counters that can be accessed for. statistical 
information about the station. They are all reset initially when the station 
is opened and are never reset. They do wrap-around at their maximum values. 
(Refer to publications for specific system product.) There is no indication of a 
wrap-around, thus it is necessary to interrogate them frequently enough to be 
able to recognize the condition. 


FRAMERECE | VEDCOUNTER 


This attribute contains the number of frames received by the station. 


FCSFAILURECOUNTER 


This attribute contains the number of FCS failures recorded by the station. 
FRAMESENTCOUNTER 


This attribute contains the number of frames sent by the station. 
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|FRAMESENTCOUNTER 


This attribute contains the number of |-Frames sent by the station. 


REMOTEBUSYMONITOR = SET or RESET 


This attribute should be set to allow the station to inform the Station Level 
manager when a neighbor becomes busy. This is used in conjunction with the 
NEIGHBOR BUSY TIMEOUT. This is used to allow logging of the neighbor link busy 
condition. 


ACU-Station Attributes 


The following are required for switched BDLC stations with ACU only: 


ACURSPTIMER . = <time-interval> 


range: 8.5 to 40.5 secs. 


This timer attribute sets the time interval between ACU (automatic call unit) 
logical steps, for example, between call-request and data-line-occupied, or 
between digit-present and present-next-digit. If this timer times out, it would 
indicate a failure to make the outgoing call. Local telephone company 
requirements should be consulted for this value. 


DI ALRETRYCOUNT = <jnteger> 


This attribute sets the limit of attempts to make a physical connection using 
auto-dial facilities. This limit is usually specified by the local telephone 
company, so refer to their requirements. 


DPRDELAYTIMER = <time-interval> 


range: 2 to 10 milliseconds 


This timer attribute sets the timer that determines the interval between. the 
digits being placed on the modem line and the time that the modem is informed of 
their presence by digit-present level to the modem. Local telephone company 
requirements should be consulted for this value. 
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RETRYDELAYTIMER 


range: 1 to 5 mins. 


= <time-interval> 


Section 5 
Configurational Commands” 


When making auto~dial calls this timer attribute sets the time between the end 
of one call, or call attempt and the next. 
company requirement. 


time is a local telephone 


required 
or 
optional 


on a om on ee a a ee ee ae oe Om Ge me om Se oe oe ee em oe ow oe oe am oe ee oe oe oe ew oe we we de oe we oe om om fe we mm oe om oo oe ee ee oe om om oe oe wm oe om @ ae mo ay oe 


ACURSPTIMER 
AUTOINIT | 
CTSRSPTIMER 
DATARATESELECTOR 
DCDOFFDELAYTIMER 
DIALRESPONSETIMER 
DI ALRETRYCOUNT 
DPRDELAYTIMER 
DSRRSPTIMER 
EFFICIENCY 


FRSPTIMERLONG 
FRST | MERSHORT 
HARDWARE 
REMOTEBUSYMON! TOR 
CHECKPQINTTIMER 
MAXSEGMENTSIZE 
MON! TOR 
REMOTEBUSYMONI TOR 
RETRYDELAYTIMER 
RETRYLIMITCHECKPT 
RETRYLIMITSABMDIS 


SELECTSTANDBY 
SPEED 
WINDOWS | ZE 

Figure 


45% 
95% 


required 
optional 
required 
optional 
required 
required 
required 
required 
required 
optional 


required 
required 
required 
optional 
required 
optional 
optional 
optional 
required 
optional 
optional 
optional 
required 
optional 


ACU - attribute 
Station Level Manager 
BDLC Station Group 
BDLC Station Group 
BDLC Station Group 
BDLC Station Group 
ACU - attribute 
ACU - attribute 
BDLC Station Group 
Station Group 

BDLC SWITCHED 

BDLC DEDICATED 
BDLC Station Group 
BDLC Station Group 
Station Level Manager 
BDLC Station Group 
BDL€ Station Group 
Station Level Manager 
Station Level Manager 
BDLC Station Group 
ACU - attribute 
BDLC Station Group 
BDLC Station Group 
BOLC Station Group 
Station Level Manager 
BDLC Station Group 
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Section 5 
Configurational Commands Station Level Commands 


STATION COMMANDS 


Order of Entering Station Commands 


As certain commands can refer to information of another command, related 
commands must be entered in the following order: 


ADD PROFILE. 
ADD STATION. 
ADD ENSEMBLE. 
ADD CONNECTION. 


For example, ensembles and connections need not be added unless they are used by 
the CALL commands, but if they are used, they must be added in the order’ showh. 
Profiles are only needed if they are required by subsequent ADD STATION 
commands, and then they must be added in the order shown. 


With the exception of DELETE PROFILE, when deleting, these commands must be 
entered in reverse order. DELETE PROFILE may deleted any time after ai station 
has been added and there are no dependent add stations required. 


Station Profile Commands 


The Profile commands, ADD and DELETE PROFILE, add or delete a list of attributes 
known by a profile name. . 


Profiles are a collection of station attribute names and values which can be 
defined independently of any station, but which can be used later as a source of 
attribute values when stations are added to the node's network configuration. 


Deleting a profile (and subsequently redefining it) has absolutely no effect on 
a station which was added using that profile. The profile is not a= station 
attribute; it is merely a source of attribute values at the time a station is 
added. 


No error checking about the validity of station attributes is made when profiles 
are added, other than the correctness of the attribute name and associated type 
of value. Appropriateness and validity checks are performed when the station is 
added and later used. 
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Command Syntax 


Response Syntax 
<proftileé=name> ADDED ‘AS PROP LLE. HSe-e-rassaaoersecerossee= 


Semantics 


This command adds the station attributes to the station level as a list of 
attributes known by the <profile-name>. This list can be used later as a source 
of attribute values when stations are added to the node's network configuration. 


No error checking about the validity of station attributes is made when profiles 
are added, other than the correctness of the attribute name and associated type 


of value. Appropriateness and validity checks are performed when the station is 
added and later used. 


Examples 
ADD PROFILE BDLCTYPE (SPEED = 5000, EFF = 60, .. .) 


=> PROFILE BDOLCTYPE ADDED 


Error Messages 


PROFILE ALREADY DEFINED 
- if a profile of the same name was previously defined. 


INVALID STATION ATTRIBUTE NAME 
- if an attribute is specified which is not a potentially settable station 
attribute. 


INVALID STATION ATTRIBUTE VALUE 
- if an attribute value of the wrong type is specified. 


Section 5 
Configurational Commands Station Level Commands 


DELETE PROFILE 


Command Syntax 


DELETE. PROR ULE <profile=name> o=Sess9 sere aonSoseeee cesses 


Response Syntax 
<profile-name> DELETED AS PROFILE ------------------------- 


Semantics 

This command removes the list of station attributes known as <profile-name>. 
Deleting a profile has no effect on the station, or stations, added using that 
profile. The profile is not a station attribute; it is merely a source of 
attribute values at the time a station is added. 

Examples 

DELETE PROFILE BDLCTYPE 


=> PROFILE BDLCTYPE DELETED 


Error Messages 


PROFILE NOT DEFINED 
- if a profile is to be deleted which does not exist. 


ADD STATION Section 5 


_ Station Level Commands Configurational Commands_ 


Add Station Command 


Command Syntax 


ADD STATION -- <sta-name> -- ( -- TYPE = --- BDLCDEDICATED ----- > 


~ BDLCSWITCHEDACU - 


- BDLCSWITCHED ---- 


~--/2\- , -- PROFILE = <prof-name> --- 


--- , - <attribute-name> = <value> --- 


Response Syntax 


<station-name> ADDED AS STATION 


Semantics 


This command adds a BDLC station to the node's network configuration. The 
attribute values specified are for the station itself, plus those in the Station 
Level Manager station table. Zero, one or two profiles can be specified, and if 
specified, must appear before any attributes. 


The values for the station attributes are taken from default values, for those 
attributes which have defaults. These values are then supplemented and possibly 
overridden by the values taken from one or two profiles, if specified, and 
finally by the attribute values supplied with the ADD STATION’ command. 
(Override applies if the same attribute is supplied from two or more_- sources.) 
If two profiles are specified, the one listed second supplements and possibly 
overrides the one listed first. 
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Configurational Commands Station Level Commands 


The ADD STATION command is used to add a BDLC station. The TYPE specified is 
either BDLC DEDICATED, BDLC SWITCHED with ACU, or BDLC SWITCHED. 


BDLC DEDICATED is used for permanent connections. 


BDLC SWITCHED with ACU is used for switched connections where the cal! is 
established by automatic dialout. 


BDLC SWITCHED is used for switched connections in one of two ways: 1) to 
receive incoming calls, or 2) to establish an outgoing call by manual 
dialout. 


The Operational commands, ESTABLISH CALL and AWAIT CALL describe the behavior of 
these kinds of stations in making calls with neighbor nodes. 


Examples 


ADD STA CAD (TYPE = BDLCDED, PROF = Pl, PROF P2) 


=> CAD ADDED AS STATION 


Error Messages 


IMPROPER SETTING OF STATION ATTRIBUTE 
- if this attribute cannot be set. 


NO MORE THAN TWO PROFILES MAY BE SPECIFIED 


INVALID PROFILE REFERENCE 
- Profile not defined. 


ATTRIBUTE INCONSISTENT WITH STATION TYPE 
- if attributes specified are inconsistent with the STATION TYPE (see 
Station Attributes below). 


ALL REQUIRED ATTRIBUTES NOT SET 


Section 5 


DELETE STATION Station Level Commands Configurational Commands: 
Delete Station Command 

Command Syntax 

DELETE STATION --- <station-name> ----- preabsie pi n eanieis 


Response Syntax 
<station-name> DELETED AS BDLC STATION 


Semantics 
This deletes the specified station from the network configuration of the node. 


An error is returned and the delete does not take place if the station is part 
of an ensemble or connection, or if the station is in use for a call. 


Examples 
DELETE STA CAD 


=> CAD DELETED AS STATION 


Error Messages 
INVALID STATION 

- Station does not exist. 
NOT DELETED, STATION IN USE 


NOT DELETED, STATION IN ENSEMBLE 


NOT DELETED, STATION IN CONNECTION 
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Configurational Commands Station Level Commands 


Modify Station Command 


Command Syntax 


Kore ee ee- yo totter ree 
MODIFY STATION -- <sta-name> (-- <sta-att> = <value> --) =| 
Response Syntax 
<station-name> MODIFIED AS STATION -------------- 


Semantics 


This command permits certain attributes of an existing station to be changed. 
Only those attributes specified with this command are changed. 


NOTE 
Some attribute changes require that the station be 
disconnected, while others do not, and still others may 


never be changed. — 


Examples 
MOD STA CAD (MONITOR = ON) 


=> CAD MODIFIED AS STATION 


Error Messages 


STATION ATTRIBUTE MAY NOT BE SET 


STATION NOT CLOSED 
- An attribute that can only be changed when station closed has been 


requested to be changed when station is open. 
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ENSEMBLE COMMANDS 


Add Ensemble Command 


Command Syntax 


>--- INCOMING ---( --- <bdlc-switched-sta-name>---- )---| 


- OUTGOING - 


- PERMANENT -- ( ---- <bdlc-ded-sta-name> ---- ) -- 


Response Syntax 


<ensemble-name> ADDED AS ENSEMBLE 
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Configurational Commands Station Level Commands 
Semantics 


This command defines an ensemble of stations. Ensembles so defined can later be 
referenced in defining connections and in establishing calls. 


An ensemble can be either incoming, outgoing, or permanent. The stations in the 
ensemble must be one of the following: 


All BDLC switched (for in or out ensembles) . 
All BDLC permanent. 


Examples 


ADD ENS NITELINES IN (STAONE, STATWO) 
ADD ENS MAINLINE PERM (XPVA, XPVB, XPVC) 
ADD ENS GROUPLINE OUT (GROUPX) 


Error Messages 


ENSEMBLE ALREADY ADDED 
STATIONS IN ENSEMBLE HAVE NOT BEEN ADDED 


STATIONS IN ENSEMBLE NOT OF PROPER TYPE 
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Delete and Modify Ensemble Commands 
Command Syntax 


DELETE ENSEMBLE <ensemble-name> -------------------------- 


~ —m— 


Response Syntax 
<ensemble-name> DELETED AS ENSEMBLE 


Semantics 


The DELETE ENSEMBLE command removes the ensemble definition from the Station 
Level. 


The DELETE command may not be entered when the ensemble is being used by an 
existing call, or if the ensemble is being referenced by an existing connection. 


Examples 


DEL ENS NITELINES 


=> NITELINES DELETED AS ENSEMBLE 


Error Messages 


ENSEMBLE IN USE, MAY NOT BE DELETED 


NO SUCH ENSEMBLE 
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MODIFY ENSEMBLE 


Command Syntax 


MODIFY ENSEMBLE <ens-name> --- + --( --- <sta-name>--- )--| 


Response Syntax 
<ensemble-name> MODIFIED AS ENSEMBLE - 


Semantics 


The MODIFY ENSEMBLE command adds or deletes stations from the ensemble. The 
last remaining station in an ensemble cannot be deleted by use of MODIFY 
ENSEMBLE; DELETE ENSEMBLE must be used for this. 


Examples 


MODIFY ENS NITELINES + (STASIX, STAFOUR) 


=> NITELINES MODIFIED AS ENSEMBLE 


Error Messages 


DELETED STATION NOT IN ENSEMBLE 
LAST REMAINING STATION MAY NOT BE DELETED 
ADDED STATION(S) OF IMPROPER TYPE 


NO SUCH ENSEMBLE 
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ADD CONNECTION 


NEIGHBOR CONNECTION COMMANDS 


These commands provide station related information for later Establish Call 
commands, or for implicit (automatic) call establishment. 


In the following command syntaxes, <neighbor> is: 


so Se <NOSE “hanes “Haas esa eeew ase ee Sanna 
- #<node address> ------------- 


~ <host-name> #<node-address> - 
Add Connection Command 


Command Syntax 


ADD CONNECTION --- INCOMING ---- WITH --- <neighbor> ------ > 
oo = OUTGOING > 
= PERMANENT = 
SOO: one ee see eee <station=-name> s=S=s-sSs-s+--- > 
Ne STATION - 
: ENSEMBLE --- <ensemble-name> ------ 
Dm nn ee ee eee ee | 
Kemer en een ----- po ttre re nen eee | 
-- (---- INITQUANTITY = <integer> ------------ 
. CALLDATA = ~--- <bdlce-call-data> | 
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ADD CONNECTION 


Response Syntax 


CONNECTION ADDED WITH <neighbor> 


Semantics 


The ADD CONNECTION command is used to define potential connections between the 
stations of the local node and its neighbors. The command does not directly 
open any actual connections. It is used to provide information for automatic 
call establishment, and for subsequent ESTABLISH CALL, and AWAIT CALL commands. 


There are three directions, or types of connections: permanent, incoming, and 
outgoing. Permanent connections apply only to dedicated type stations; incoming 
and outgoing connections apply to BDLC switched stations. Both incoming and 


outgoing may be defined for a switched station. One or more connections may be 
defined for a given neighbor. 


The ADD CONNECTION commands for permanent and incoming connections are similar 
in effect. If a station has connections defined with certain nodes, then only 
those nodes will be permitted to establish connections via that station. If the 
Station has no connections defined, then no such restrictions will be applied 
(uniess the <neighbor> information is supplied with an ESTABLISH CALL command). 
Incoming connections apply only to incoming calls received on a_e switched 
station. A call is considered to be incoming if the AWAIT CALL command was 
issued for the station, or if a call was initiated due to a station having 
AUTOINIT true. A call is considered outgoing if the ESTABLISH CALL was used. 
There is a case where a call is started as outgoing, but becomes incoming due to 
a call collision and the acceptance of the incoming call. 


The ADD CONNECTION commands for outgoing connections are somewhat different. For 
switched stations with an ACU, they primarily provide a means of storing a 
telephone number used to call a particular node. They can also be used to 
request that, at initialization time, a cal] automatically be placed to that 
node, by the specified station. These two features are available through’ the 
use of the attributes INITQUANTITY and CALLDATA. 


INITQUANTITY represents the number of calls that should be placed, at 
initialization time, by the specified station, or ensemble of stations. For a 
single station, the only valid values are zero (0) or one (1). For an ensemble, 
the valid values are zero to the number of stations in the ensemble. The 
default value in either case is zero. 


CALLDATA is a telephone number. Where multiple calls are made to a neighbor, in 
the case of an ensemble of stations, the neighbor telephone number must 
represent the "hunting'’ telephone number. A hunting telephone number is a 
feature provided by many telephone services. It allows a group of lines to be 
called using a single telephone number, and only when all numbers are in-use 
will the call be found busy. For further detail on the telephone number, refer 
to BDLC CALL DATA, in Appendix A. 


x Section 5 
ADD CONNECTION Neighbor Connection Commands Configurational Commands _ 


Semantics Summary 
INCOMING connections: 


Incoming connections may be specified by using a BDLC switched station, or 
an ensemble of BDLC switched stations. 


OUTGOING connections: 


Outgoing connections may be specified using a BDLC switched station with 
ACU or an ensemble of such stations. 


INITQUANTITY may be specified; this determines the number of outgoing calls 
attempted automatically at initialization. The default value is zero. 


CALL DATA must be specified for outgoing calls on BDLC stations with ACU. 
PERMANENT connections: 


Permanent connections specify either a dedicated BDLC station, or an 
ensemble of such stations. 


Examples 


ADD CONN IN WITH CENTRAL #5 BY STATWO 


ADD CONN OUT WITH CENTRAL BY ENS NITELINES 
(CALLDATA = "1-215-492-1234", INITQUANT = 1) 


Error Messages 


IMPROPER ENSEMBLE KIND 
- if ensemble is not of correct kind (IN, OUT, or PERM). 


NEIGHBOR !S NOT A NODE 
- if ROUTER VAL is true and neighbor was not added as a node. 


IMPROPER STATION KIND 
- if station type is not compatible with connection type. 


INCORRECT PARAMETERS 
- if INIT QUANT or CALL DATA is specified for PERM or IN connections, or 
CALL DATA omitted for OUTGOING connections. 
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Delete and Modify Connection Commands 
Command Syntax 


DELETE CONNECTION --- <connection-definition> ----c-r-err------ > 


- STATION - 


- ENSEMBLE --- <ensemble-name> ------ 


Response Syntax 
CONNECTION DELETED WITH <neighbor> 


Semantics 


The DELETE command deletes a specified connection with a neighbor, provided that 
connection is not in use by a call. 


lf the WITH <neighbor> phrase is omitted, connections with all neighbors that 


are OUTGOING are deleted, provided none of these are in use. 


Examples 
DEL CONN IN WITH CENTRAL #5 BY STATWO 


=> CONNECTION DELETED WITH CENTRAL #5 


Error Messages 


NO SUCH CONNECTION 
- jf the connection specified (by the connection definition) was not added. 


CONNECTION IN USE 
- if the connection is in use for a call. 
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Neighbor Connection Commands Configurational Commands” 


Command Syntax 


MODIFY CONNECTION --- OUTGOING ---------------------- anon----- > 


|. WITH -- <neighbor> -- 


~ STATION _| 


- ENSEMBLE --- <ensemble-name> --~---- 


Response Syntax 


CONNECTION MODIFIED WITH <neighbor> 


Semantics 
The MODIFY command modifies a specified connection with a neighbor. 
The connection information, INITIAL QUANTITY and CALL DATA, can be changed by 


the MODIFY CONNECTION command. However, if the connection is in use, the 
changes will only take effect after the connection has been closed. 


Examples 
MOD CONN OUT WITH CENTRAL BY ENS NITELINES (INITQUANT = 2) 
=> CONNECTION MODIFIED WITH CENTRAL #5 
Error Messages 
NO SUCH CONNECTION 
CONNECTION IN USE 
IMPROPER PARAMETER (S) SPECIFIED 
~ if the INIT QUANT or CALL DATA is incorrectly specified for the connection 


(note that no parameters exist for INCOMING or PERMANENT connections, so 
these connections cannot be modified). 


AWAITCALL 


SECTION 6 
OPERATIONAL COMMANDS 


Operational Commands are commands which cause node actions that relate to the 
network, by making or breaking neighbor connection, by breaking a _ host-to-host 
(port-level) communication, or by performing special routing actions. 


The Operational commands can be entered only during the 


operating phase of 
Network mode. 


NOTE 
To establish and break communications with a Program 
Agent are operational functions. However, the 
operational command to perform these functions, PROGRAM, 
is not discussed in this section. For detail of the 
PROGRAM command, refer to Section 3. 


CALLS WITH NEIGHBOR COMMANDS 


These commands affect the communications to a neighbor. The commands are: 
ESTABLISH CALL, AWAIT CALL, CLEAR CALL, SAVE STATION, and READY STATION. 


AWAIT CALL COMMAND 


Command Syntax 


AWAITCALL BY ---------------- 
- STATION - 


- ENSEMBLE --- <ensemble-name> ------ 


Response Syntax 


CALLS WAITING BY STATION <station-name> 


CALLS WAITING BY ENSEMBLE <ensemb]e> 
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Semantics 


This command places the indicated station or all available stations in the 
indicated ensemble or station group into a state to receive a call. 


AWAIT CALL cannot be used for permanent stations or ensembles of permanent 
stations. 


The station, if specified, must be a switched BDLC station. The ensemble, if 
specified, must be an incoming ensemble of BDLC switched stations. 


The neighbor who initiates the call is validated if a corresponding connection 
has been added. 


An implicit AWAIT CALL occurs during initialization or when a station is made 
READY, if AUTO INIT is true. 


Examples 
AWAITCALL BY HOTLINES 


AC BY ENS GROUPX 


Error Messages 


NO SUCH ENSEMBLE 
~ if ensemble does not exist. 


IMPROPER ENSEMBLE TYPE 
~ if ensemble is of incorrect type. 


NO SUCH STATION 
NO SUCH STATION GROUP 
IMPROPER STATION TYPE 


- if BDOLC station is of wrong type. 


NO STATION AVAILABLE 
- if all stations in the specified ensemble are unavailable. 


STATION NOT AVAILABLE 
- if the station specified is unavailable (that is, busy or saved). 


VALIDATION FAILURE 
- if neighbor called has failed validation. 
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Operational Commands Calls with Neighbor Commands 


STATION FAILURE: <reason> 
- if BDLC station reports a failure. 


CLEAR CALL COMMAND 


Command Syntax 


CLEARCALL --- WITH --- <neighbor> --------- nnn nen n renner renee 
FAD os ter ene ere <station-name> -------- 
- STATION - 
- ENSEMBLE ---- <ensemble-name> ------- 


Response Syntax 


CALLS CLEARED WITH <neighbor> 


CALLS CLEARED BY... (as specified in command above) 


Semantics 

This command clears one or more calls to a neighbor. 

[f the neighbor is specified, ail calls to that neighbor are cleared. 
lf a station is specified, the call on that station is cleared. 


lf an ensemble is specified, all stations in that ensemble are cleared. 


Examples 
CLEARCALL WITH BRANCH2 


CC BY ENS NITELINES 
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ESTABLISHCALL 


Calls with Neighbor Commands 


Error Messages 


STATION ALREADY CLOSED 

NO CALLS WITH NEIGHBOR EXIST 

ALL STATIONS IN ENSEMBLE ARE CLOSED 
NO SUCH STATION 


NO SUCH ENSEMBLE 


ESTABLISH CALL COMMAND 


Command Syntax 


ESTABLISHCALL ----------------------------------- > 


= WITH <neighbor> --- 


- STATION _| 


- ENSEMBLE --- <ensemble-name> ------ 
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Section 6 
Operational Commands Calls’ with Neighbor Commands | 


Semantics 


This command establishes one or more new calls to neighbor nodes. The forms of 
this command, and the functions performed are described as follows: 


ESTABLISHCALL BY permanent station: 
ESTABLISHCALL WITH neighbor BY permanent station: 


Establish a new call with this neighbor using the specified station. The 
WITH <neighbor> clause is optional; if supplied, the identity of the 
neighbor is validated. 


ESTABLISHCALL BY permanent ensemble: 


Create one or more new calls using all of the stations in the permanent 
ensemble. Validate the neighbor identities if an appropriate connection was 
previously entered. The WITH <neighbor> clause must not appear. 


ESTABLISHCALL WITH neighbor BY auto-dial station: 
ESTABLISHCALL WITH neighbor BY auto-dial station 
(CALLDATA = <bdle-call-data>): 


Establish a new call with this neighbor using the specified station. The 
Station must be of type BDLC-switched-with-ACU. The WITH <neighbor> clause 
must appear, and the neighbor identity is validated. CALLDATA is optional; 
it is discussed below. 


ESTABLISHCALL WITH neighbor BY outgoing ensemble: 
ESTABLISHCALL WITH neighbor BY outgoing ensemble 
(CALLDATA = <bdlc-call-data>) : 


Establish a new call with the neighbor using the first available station in 
the outgoing ensemble. (The ensemble contains BDLC switched stations with 
ACU.) The WITH <neighbor> clause must appear, and the neighbor identity is 
validated. CALLDATA is optional; it is discussed below. 


ESTABLISHCALL WITH neighbor BY manual-dialout station: 


Establish a new call by setting this station, which is a BDLC_ switched 
station without ACU, so that it can be used for manual dialout. The 
operator uses this station to manually dial a neighbor. The identity of 
the neighbor is validated. CALLDATA must not appear. 


ESTABLISHCALL 
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When CALL DATA may be used: 


Call data applies only to a switched BDLC station with ACU, or to an 
outgoing ensemble of such stations. Where it applies, the rule for using 
call data is as follows: 


If, previously, an outgoing connection to that neighbor was added, CALLDATA 
information must not appear with this command (since it was supplied by the 
connection entry). If no such connection was previously added, the 
CALLDATA information must be supplied with this command, and applies only 
for the duration of this call. 


Automatic Establish Calls at Initialization: 


During initialization, an ESTABLISH CALL is generated for a _ permanent 
station for which AUTO INIT is set to TRUE. Further, for switched outgoing 
connections in which INIT QUANTITY is set to a nonzero value, on, then 
during initialization, n number of ESTABLISH CALLs are generated using the 
stations specified in that connection. 


Response Syntax 

CALL ESTABLISHED BY <station or ensemb]e> 
This response is returned when a call establishment by a single station is 
requested and succeeds immediately. A call establishment by a= single 


station is requested by specifying one of the following in the ESTABLISH 
CALL command: 


. A permanent station, BDLC DEDICATED. 


. A BDLC switched station, with ACU for auto-dial, or 
without ACU for manual dial. 


. An outgoing ensemble, used to select a switched 
station. 


CALL INITIATED BY <permanent station> 
This is returned when a permanent station is specified and no error is 
encountered, but the corresponding remote station iS in a pending open 
state. Note that an ATTACH report is given later when this remote station 
establishes the other end of the call. 

CALLS IN PROCESS BY <permanent ensemble> 
This is returned when an ensemble of permanent stations is specified. In 


this case, an immediate response is given indicating that the command has 
begun to be serviced. Then later, as a call is being established with EACH 
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station in the ensemble, a report is given. This report indicates if the 
call establishment is completed (an ATTACH report), if the call is 
initiated (as previously described for single permanent stations), or if an 
error has occurred (a station failure report). 


Examples 
ESTABLISHCALL WITH BRANCH2 BY STATWO 


EC WITH BRANCH2 BY ENS NITELINES (CALLDATA = ''12145551212") 


Error Messages 


NO SUCH ENSEMBLE 
- if ensemble does not exist. 


IMPROPER ENSEMBLE TYPE 
- if ensemble is of incorrect type. 


NO SUCH STATION 


IMPROPER STATION TYPE 
- if BDLC station is of wrong type. 


NO STATION AVAILABLE 
- if all stations in the specified ensemble are unavailable (unavailable 
means the station is busy with a call or is SAVED). 


STATION NOT AVAILABLE 
- if the station specified is unavailable. 


VALIDATION FAILURE 
- if neighbor called has failed validation. 


STATION FAILURE: <reason> 
- if BDLC station reports a failure. 


CALL DATA REQUIRED 


CALL DATA NOT REQUIRED 
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SAVE AND READY STATION COMMANDS 


Command Syntax 


Response Syntax 
STATION <station-or-group-name> READIED 


Semantics 
The READY STATION command does the following: if the Station is connected, it 
removes the to-be-saved mark; if the Station is saved, it makes the station 


available again. In the latter case the call is re-established if AUTO INIT is 
true. 


Error Messages 


INVALID STATION NAME 
- if Station does not exist or syntactically invalid. 
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Command Syntax 


Response Syntax 
STATION <station-or-group-name> TO BE SAVED 


Semantics 


The SAVE STATION command does the following: if the station is connected, it 
marks the station to be saved later, when it becomes disconnected (by a cal] 
terminating or the station being cleared). if the station is already 
disconnected, this command takes immediate effect and the station becomes 
unavailable to be connected (that is, SAVED). 


Error Messages 


INVALID STATION NAME 
~ if Station does not exist or syntactically invalid. 
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HOST-TO-HOST COMMUNICATIONS 


These commands concern host-to-host communications. They are CLEAR HOST, SAVE 
HOST, and READY HOST. 


Command Syntax 


CLEAR “}==— HOST: <nest=neme> “ss<essS— ose SesSeeeenaeeeeeee= 
- #<node-address> - 

Response Syntax 

HOST <host-name> #<node-address> ------ CLEARED ------------ 


Semantics 

The CLEAR HOST command abruptly severs all user communication to a host, but new 
communications can then begin. That is, open or opening subports are 
immediately deactivated. However, Port Level communication is not severed; and 
after the CLEAR, unless a previous SAVE was done, new user subports can be 
opened. 

Error Messages 

NO SUCH REMOTE HOST 


- if remote host is unknown to the Port Level. 


Command Syntax 


- #<node-address> - 


Response Syntax 


HOST <host-name> #<node-address> ------ READIED ------------ 
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Operational Commands Host-to-Host Communications 


Semantics 

The READY HOST command removes the SAVE status of the remote host, and the 
remote host, when present, is available for opening new subports. 

Error Messages 

NO SUCH REMOTE HOST 


-~ if remote host is unknown to the Port Level. 


Command Syntax 


SAVE -~-~--~ HOS) -<hos t=hame> = "Sas" e Secret eo rse rere esen Sess 


|- #<node-address> -| 
Response Syntax 
HOST <host-name> #<node-address> - SAVED, SUBPORTS OPEN: <intgr> == | 


Semantics 


The SAVE HOST command marks the remote host TO BE SAVED. No new subports are 
opened and any pending opens are aborted. As soon as the last subport to that 
host is closed, it is SAVED. No further subports can then be opened to. that 
host while in the SAVED state. (If there are no subports in use to that host 
when the SAVE is entered, the host is immediately SAVED.) 


Error Messages 


NO SUCH REMOTE HOST 
- if remote host is unknown to the Port Level. 


LOGCOMMENT Section 6 
ROUTINGREFRESH Other Operational Commands Operational Commands 


OTHER OPERATIONAL COMMANDS 


The commands that follow are commands that do not fall under any particular 
category. Thus they are just grouped here for convenience. 


LOG COMMENT COMMAND 
Command and Response Syntax 
epec Omen) <text> 

=> COMMENT LOGGED 


Semantics | 


This command causes text to be logged as a Network Services comment. It will be 
logged along with other Network Services logging information. 


ROUTING REFRESH COMMAND 


This command can be used to cause the local Router to update its routing tables. 
It does this by requesting routing information from its neighbors. 


Command Syntax 


ROUT INGREFRESH 


Response Syntax 
ROUTING INFORMATION REFRESHED * 
Semantics 


This command causes the Router to request all its neighbors to send NETCHANGE 
messages, from which the local routing information is updated. 
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START TRACE COMMAND 


Command Syntax 


STARTTRACE <trace-source> TO <trace-destination> 


where <trace-source> and <trace-destination> are: 
Sas <NOSt- heme, “oe R eterna ss R aera rere ska sees sree 
- #<node address> ~------------- 


- <host-name> #<node-address> - 
Response Syntax 
TRACE STARTED: <trace-source> TO <trace-destination> 


Semantics 


This command causes the Router to issue a ROUTER CONTROL FRAME to either do a 
trace start (if the local node is not the trace source) or a trace (if it is). 
The response to this command is simply an acknowledgement that the Router’ has 
sent the frame. 


When trace results are received, Routing Trace Reports are received from al] 
involved nodes. 

Examples 

START TRACE BRANCH] TO BRANCH2 


=> TRACE STARTED: BRANCH] #3 TO BRANCH2 #5 


Error Messages 


INVALID TRACE SOURCE 
~ if ROUTER VALIDATE is true and source node is invalid. 


INVALID TRACE DESTINATION 
~- {f ROUTER VALIDATE is true and destination node is invalid. 


UNREACHABLE TRACE SOURCE 


UNREACHABLE TRACE DESTINATION 
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TO 


SENDING TEXT TO AN AGENT 


This command is intended to be used for sending text messages to another Network 
Services operator (agent). In addition, it can be used as a maintenance tool 
for basic testing of the network. 


Command Syntax 


- <host-name> - 


i la ale ease <host-name> ----------- 


Response Syntax 
TEXT SENT TO <host-name> #<node-address> 


Semantics 

This command sends text to another node. The arrival of the text causes a FROM 
report (message from remote agent report). The text must be containable within 
a single Router Frame; hence, the text and associated frame header cannot exceed 
MAX SEGMENT SIZE in use to the receiving node. 

Note that the text may contain any sequence of characters except '"';'' (the 
command terminator) or ":" (the response suffix separator), unless these are 
enclosed in quoted strings. 


Error Messages 


NO SUCH HOST OR NODE 
NODE UNREACHABLE 


MESSAGE TEXT EXCEEDS MAX SEGMENT SIZE 


OPEN CPD/SD 

CLOSE CPD/SD 
VALIDATEANDATTACH 
DETACH 

SENDTEST 


SECTION 7 
STATION CONFIDENCE (MANUAL) COMMANDS 


Station Confidence commands are used to establish confidence in the_ proper 
functioning of the stations. Together with inquiry commands, they can be used 
to diagnose problems. They can be entered at any time after the Configuration 
Entry phase of network initialization, and used on stations that are not SAVED. 


Command Syntax 


OPEN. ==sS==+ CED See SStat lone Se sH ess sek seas esses seer aR 


— ob om ao om —_ om oe oe oe ow oe 


S50: s=> SSlat One scoters SrSar ass Sesseeensse-s-== 
% calldata option for 
OPEN only 


(CPD = CONNECTION PORT DIALOG) 
( SD = STATION DIALOG) 


VALIDATEANDATTACH ---------- <station> -------- 

DETACH ------------ 

SENDTEST <-- <station> -cc-oc noone nn en ee en ne eee eee 
aa <string> ------ 


-- HEX <hex-number> - 
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OPEN CPD/SD 
CLOSE CPD/SD 


VALIDATEANDATTACH Section 7 
DETACH Station Confidence 
SENDTEST __. ————s (Manual) Commands: 
Semantics 


These commands cause manual command mode messages to be passed through the 
Station Level manager to the Stations themselves. 


OPENing CPD (Connection Port Dialogue) opens the station to the extent that test 
messages can be sent. No BDLC protocol is available. Specifying CALLDATA on a 
switched BDLC station with ACU causes the station to dial the telephone number 
provided. 


OPENing a station for SD (station dialogue) opens the station and initializes 
the BDLC protocol. Test messages can be sent. If the station is defined as 
outgoing, the station commences sending SABM to establish the BDLC connection. 


VALIDATE AND ATTACHing a station causes the station to send out greetings. If 
the greetings complete successfully, the station is connected to the Router for 
normal traffic. 


DETACHing a station severs the connection between the station and the _ router, 
and leaves the station in a state that can be used for testing. If the station 
was in use, the station level report tc the router causes the station link to be 
removed from any routing. 


CLOSEing a SD (Station Dialogue) terminates the station protocol (for example, 


BDLC) function. The station will not react in any way to input data. It will, 
however, react to interface changes as recognized by the Connection Port (for 
example, it will answer an incoming call, but will not commence any dialogue). 


CLOSEing CPD (Connection Port Dialogue) causes the station to become dormant. 
It will not react in any way to changes on the link interface. 


SENDTEST can be used to send a test message to another node. The message is 
sent by the SLM (Station Level Manager) to another node SLM. At the receiving 
SLM, the message is reported to the Operations Interface and it is retransmitted 
back to the originating node. The originating SLM receives the echoed message 
and sends a report to the Operations Interface. 


The reports displayed are Test Received (remote node) and Test Echoed (local 
node). Refer to Section 10 for details of these station reports. 


The test messages can be sent when the station is being used for normal traffic, 
and when in manual mode, where the station must be open for Connection Port 
Dialogue. 


NOTE 
To manually attach a station to the Router the station 
must be opened for station dialogue, and for opening 
station dialogue it must be open for Connection Port 
Dialogue. 
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OPEN CPD/SD 

CLOSE CPD/SD 

Section 7 VALIDATEANDATTACH 
Station Confidence DETACH 
(Manual) Commands SENDTEST 


Response Syntax 
MANUAL COMMAND SERVICED ON <station> 


Also refer to Station Reports for the reports that are generated due to the 
above actions. 


Error Messages 


BDOLC FAILURE ON <station> - 
VALIDATION FAILURE ON <station> - 
this occurs in response to the VALIDATE AND ATTACH command. 
INVALID SLM PHASE 
INVALID STATION PHASE ON <station> 


ERROR, AUTO COMMAND IN PROGRESS 


COMMAND OUT OF SEQUENCE 
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SECTION 8 
SERVICE COMMANDS FOR OIM INPUT FILES 


Service commands are used to control the activity of OIM (Operations Interface 
Messages) files and to specify the disposition of responses to Operations 
Interface commands. They can be entered at any time. 


LOAD COMMAND 


Command Syntax 


Semantics 


The LOAD version of this command reads the file and services the commands in the 
order presented; if a syntax error is encountered, the reading of the file is 
aborted. 


The LOAD FOR SYNTAX version scans the file for syntax errors only; the commands 
are not otherwise serviced. 


Normally, the input file is not an initialization file because such a file is 
read automatically when Network Services is initiated. However, it is possible 
to LOAD a file while the Node is still initializing. In such an event, the 
input file is treated as a secondary initialization file. If this technique is 
used to enter additional parameters for initialization, the ENDINIT command can 
be included in the secondary initialization file. 
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LOAD OIM Output Files 


This command can be entered only from an ODT or Program Agent. Only one OIM 
input file can be in the process of being loaded at any one time. 

Examples 

LOAD CHANGEFILE 


=>LOADING CHANGEFILE 


Response Syntax 
LOADING Seeendecessesrassss <file-title> ------ 


- FOR SYNTAX - 


Error Messages 
<file-title> NOT PRESENT FOR LOADING 
IMPROPER FILE FORMAT 
- if file is not formatted as specified for an OIM input file. 


FILE LOADING IN PROCESS 
- if an OIM input file is already being loaded or is suspended. 
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OIM Output Files STOP 


STOP COMMAND 


Command Syntax 


Response Syntax 


| 
-- cuivencieies evoreeD wo n-n------------------------- | 


- AT <sequence-number> - 


If the sequence number appears, it indicates the last command serviced. 


Semantics 


This command causes the OIM input file, currently being loaded, to be suspended. 
The sequence-number displayed indicates the sequence number (if available) of 
the next command jto be executed. This file can be resumed at the point where it 
was suspended (by| a CONTINUE command) or the loading can be aborted (by a 
DISCARD command) .| While the file is suspended, other commands may be entered by 


the ODT or Program Agents. 


lf the file being| read contains a STOP command, it suspends itself. 
Program Agents cannot enter this command. 

Examples 

STOP 


=> CHANGEFILE STOPPED 
=> CHANGEFILE STOPPED AT 2351000 


Error Messages 


NO FILE BEING LOADED 


FILE ALREADY SUSPENDED 
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CONTINUE Service Commands for 
OIM Output Files 


CONTINUE COMMAND 


Command Syntax 


CONTINUE ---~-------------------------------------- 


Response Syntax 


<file-title> CONTINUED 


Semantics 

This command causes a suspended O!IM input file to resume loading. If the file 
was suspended because of an error, the file input resumes immediately after the 
erroneous command which caused the suspension. If the file was suspended by a-> 
STOP command, the file is resumed at the point of suspension. 


This command, entered from an input file, has no effect. It cannot be entered 
from a Program Agent. 


Example 
CONTINUE 


=> CHANGEFILE CONTINUED 


Error Messages 


NO SUSPENDED FILE 
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OIM Output Files | 


DISCARD COMMAND 


Command Syntax 


DISCARD -------- one nen nn nnn nee e- ne = 22+ eee -------- 


Response Syntax 
<file-title> DISCARDED 


Semantics 


This command aborts the loading of an 01M input file which has been suspended. 


This command does not discard a file if it is actively being loaded. (To do the 
latter, a STOP command followed by the DISCARD command should be entered.) 


Example 
DISCARD 


=> CHANGEFILE DISCARDED 


Error Messages 


NO SUSPENDED FILE 
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«SECTIONS 
SUMMARY AND DETAIL INQUIRIES 


This section describes inquiries that provide information about the Network 
Services operatiion. Inquiries can be detailed or summarized. Each level has 
its own view of the network, and the inquiries provide access to this 
information. This section is organized into descriptions of inquiry types: Host, 
Node, Neighbor, Routing, Profile, Station, Ensemble, Candidate, Port Counts, and 
Modes. 


In this section the inquiry command format is shown followed by the _ response 
syntax only. In most cases there are several forms of response, and each is 
described individually. There are no error messages except for the syntax 
errors described in Section 1. 


HOST SUMMARY AND DETAIL 


Command Syntax 


|. <host-name> -- 


The HOST form of this inquiry returns a list of hosts with summary information 
about each. 


The HOST <host7+name> form returns detailed information about the host selected. 


Response Syntax 


The detailed responses are described in the following subsections, Host Summary 
and Host Detail. 


Section 9 
Cost Summary _ Detail Summary and Detail Inquiries 


HOST 
HOST SUMMARIES 


Using the "HOST" form of the HOST command results in the response: 


=> HOST --- <host> (--- UNAVAILABLE --------------- ) ---| 


- INACTIVE ----------------- 
- GREETING ----------------- 
- TERMINATING -------------- 
- INTERRUPTED -------------- 


- ACTIVE ------------------- 


where <host> is 
~-- <host-name> #<node-address> ----- | 


This summary displays the state of each host that is in communication with the 
local host. It reflects the states of the port levels in each host. 


INVALID is returned when the host is marked ''FOR TRANSLATE ONLY". 
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Summary and Detail Inquiries Host Summary Detail rs 
HOST DETAIL 


Using the "HOST Khost-name>"' form of the Host command results in the response: 


=> HOST ----| <host-name> #<node-address> ~------------ > 
>- ( --- UNAVAILABLE ------------------ »READY,----> 
- , INVALID -| |- seiiee!| 
- ||NACTIVE -----~----------- 
- GREETING ----------------- 
- TERMINATING -------------- 
- |INTERRUPTED -------------- 
- ACTIVE ------------------- 
a pT rr nen nnn | 
aa aaa MAX SEGMENT SIZE --- = --- <integer> ------ =] 
- acuiiees 
- SUBPORTS IN USE ---- = <integer> --------- 
- PROTOCOL LEVEL IN USE = <integer> --------- 


This detailed summary provides enhanced 


host. 


host information about a specific remote 
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NODE SUMMARIES 


This inquiry provides information regarding the reachability of all known nodes. 


Response Syntax 


|- : ==> REACHABLE ----- | 


. UNREACHABLE | 


NEIGHBOR AND CONNECTION INFORMATION 


NEIGHBOR werent nnn rn nn nn nn rrr nnn nnn nen nen n= 
=== ACTIVE ===s<=- | 
“~~ CONNECTION ------ <neighbor> ---- 


--- DETAIL ------- | 


"NEIGHBOR" or "NEIGHBOR ACTIVE" returns a list of neighbors and summmary 
information about each (ACTIVE specifies only active neighbors; the unqualified 
form specifies all neighbors, potential and active). 


"NEIGHBOR CONNECTION <neighbor>"' returns connection information with the 
specified neighbor. 


"NEIGHBOR DETAIL <neighbor>"' returns detailed information about the specified 
neighbor. 
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Summary and Detail Inquiries Neighbor and Connection Information 


Response Syntax 

The following subsections Neighbor Summaries, Neighbor Connection Information, 
and Neighbor Detail describe the form of the responses. 

Neighbor Summaries 


Using the "NEIGHBOR" or "NEIGHBOR ACTIVE" entry of the NEIGHBOR command results 
in the response!: 


=> NEIGHBOR --- <host-n> #<node-a> --- DISCONNECTED ----- | 


- BY <sta-list> | 
where <stattion-list> is: 
=e <bdic-s|ta-name> : --- BDLC DEDICATED --------------| 


- BDLC SWITCHED ----------- | 


|- BDLC SWITCHED ACU ------- 


DISCONNECTED is returned when the NEIGHBOR STATUS is CLOSED. If ACTIVE is 
specified, these neighbors are not listed. 
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NEIGHBOR Section 9 


Neighbor and Connection Information Summary and Detail Inquiries 


Neighbor Connection Information 


Using the "NEIGHBOR CONNECTION <neighbor>'" form of the NEIGHBOR 
command results in the response: 


=> CONNECTION WITH <neighbor> --- <connection-info> ---| 


where <connection-information> is: 


---- INCOMING --- BY--- STATION <station-name> -------- > 
- QUTGOING - - ENSEMBLE --- <ensemb]e-name>- 
- PERMANENT- 
aaa hl tet ae eather atata alate atatataaatatatetetaeteiatatatatealatateteetetatate > 
Qe een eee e--------- ee | 
-- (---- INITQUANTITY = <integer> ------------ = 


|. CALLDATA © ---- <bdlc-call-data> - 


- ATTACHED BY --------- <station> ---------------- 


where <station> is defined as: 
~--- <bdic-station-name> : --- BDLC DEDICATED --------- 
- BDLC SWITCHED ------ 


- BDLC SWITCHED ACU -- 
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Neighbor Detail 


Using the "NEIGHBOR DETAIL <neighbor>" form of the NEIGHBOR command results in 
two types of response. Neighbor Connected, or Not Connected determines the type 
of response. A/description of both forms of the response fol lows: 


If neighbor is connected: 


=> NEIGHBOR <host-name> #<node-address> -c---ce ern ---- > 
<----- pee en nn eee eee peewee n nee 
pee (----- WORKING RESISTANCE FACTOR = <integer> ------ ) <--> 
- REMOTE RESISTANCE FACTOR = <jnteger> - 
- LOCAL RESISTANCE FACTOR = <jnteger> - 


- OPERATIONS RESISTANCE FACTOR = <integer> - 


|- MAX SEGMENT SIZE IN USE = <integer> - 


| 
>- LINKED ON woe <sta> (----- SPEED ----- = <integer>---) ---> 
- EFFICIENCY = <integer>- 


~ MAX SEG SIZE= <integer>- 


where <station> is defined as: 

--- <bdic-statijon-name> ; --- BDLC DEDICATED ---------- 
- BDLC SWITCHED --------- 
- BDLC SWITCHED ACU ----- 


If neighbor is not connected: 


=> NEIGHBOR <host-name> #<node-address> NOT CONNECTED 
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ROUTING INFORMATION 


This inquiry provides local routing table information. 
Command Syntax 


ROUTINGS one nnn nnn nnn nnn nnn nnn nnn nn nnn nn nen nnn nnn nen eee 


Response Syntax 

Several types of response syntax are provided for this inquiry. The following 
subsections, Responses for Destination Inquiries (TO <node>), and Responses for 
Neighbor Routings (VIA <node>) describe these responses. 


In each of the responses, <routing-info> is: 


-- RESISTANCE FACTOR = <integer> - 
-- HOP COUNT -~---- = <integer> - 
~- MAX SEGMENT SIZE = <integer> - 
Note that INUSE is present only if true for the given routing. 


Also in the following responses, <node> is: 


--- <host-name> #<node-address> --- 
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i ROUTINGS 
Summary and Detail Inquiries Routing Information 


Responses for Destination Inquiries (TO <node>) 


Using the "ROUTINGS" or "ROUTINGS TO ALL" form of the ROUTING command results in 
the response: 


=> 
gonna penn ------ +--+ 7 oe 
Moe eet 2 Bere eoetoule 
ROUTINGS---TO <hode> ---- VIA <node> --- UNREACHABLE ------- | 
- (<rout-info>) - 
w= (UNREACHABLE :exeuseoncadeeosaces 


These commands return all routings for every destination node, arranged by 
destination node, and then, for each destination node, all of the neighbor nodes 
potentially usable to reach that destination. 

Using the "ROUTINGS TO <node>" form of the ROUTINGS command results in the 
response: 


=> 


ROUTINGS TO <node> ----- VIA <node> --- UNREACHABLE ------- | 
= ren 
~- UNREACHABLE --------------------- 


This displays all routings for a specified destination node, displaying each 
neighbor node which is potentially usable to reach that destination. 
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Routing Information Summary and Detail Inquiries 


Using the "ROUTINGS INUSE" or "ROUTINGS INUSE TO ALL" form of the ROUTINGS 
command results in the response: 


=> INUSE ROUTINGS --- TO <node> --- VIA <node> (<rout-info>) ---| 
----- UNREACHABLE -------- 


These return in-use routings for every reachable destination node, showing the 
neighbor node currently used to reach each destination. 


Using the "ROUTINGS INUSE TO <node>'" form of the ROUTINGS command results in the 
response: 


=> |INUSE ROUTING TO <node> --- VIA <node> (<rout-info>) ---| 
- UNREACHABLE -------------- 
This returns in-use routing for a specified destination. If destination is 


unreachable (no in-use routing exists) then UNREACHABLE is displayed. 


Responses for Neighbor Routings (VIA <node>) 


Using the "ROUTINGS VIA ALL" form of the ROUTINGS command results in the 
response: 


=> Qeemeacenee were ne wena we §¢ sew ewe men www ewe www ee ee oe 
ROUTINGS --- VIA <node>--- TO <node> --- UNREACHABLE ------- | 


> Soap 


This returns all routings for every neighbor node, showing for each neighbor a 
list of all destination nodes potentially reachable through that neighbor. 
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Secon? ROUTINGS 


Summary and Detail Inquiries Routing Information 


Using the "ROUTIINGS VIA <node>"' form of the ROUTINGS commands results in the 
response: 


=> ROUTINGS VIA <node> --- TO <node> -- (<rout-info>) ----| 
- UNREACHABLE - 


This returns all routings for specified neighbor node, showing a list of all 
destination nodes potentially reachable through that neighbor. 


Using the “ROUT INGS INUSE VIA ALL" form of the ROUTINGS command results in the 


response: 


= feet ease etn Ses See rene eenan eee: 
INUSE ROUTINGS ~H-VIA <node> ---T0 <node> (<rout-info>) ----- | 


This returns in-use routing information for all neighbor nodes, showing the 
destinations currently reachable through each neighbor. 


Using the "ROUTINGS INUSE VIA <node>" form of the ROUTINGS command results’ the 
response: 


=> |NUSE ROUTINGS VIA <node>-- TO <node> (<rout-info>) =| 


This returns in-use routing information for the specified neighbor node, showing 
the destinationsicurrently reachable through that neighbor. 
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Section 9 
PROFILE a Stummary and Detail_Inquirics. 


PROFILE SUMMARY AND DETAIL 


These commands provide information about station profiles of a local node. 
There are two forms of the command, PROFILE, and PROFILE <profile-name>. 


"PROFILE" returns a list of profile names. 
“PROFILE <profile-name>"' returns the list of station attributes and values 
contained in that profile. 


Command Syntax 


PROFILE ------------------~-------------------------------- 


-- <profile-name> -- 
Response Syntax 
The two forms of response follow: 


Using the "PROFILE" form of the PROFILE command results in the response: 


This is a list of profile names currently known by the Station Level. 


Using the "PROFILE <profile-name>"' form of the PROFILE command results in the 
response: 


=> PROFILE <prof-name> (-- <sta-attr> = <value> --)-| 


This is a list of station attributes associated with the profile. 
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Section 9 STATION 


Summary and Detail Inquiries 


STATION SUMMARY AND DETAIL 


The STATION inquiry command provides various information about the stations. It 
can be used to provide station status information, station attribute 
information, and station COUNTS information. There are two major forms of the 
command: STATION and STATION <sta-name>. 


The "STATION form returns a list of stations with summary information about 
each. The "STATION <sta-name>" returns detailed information about the station 
selected. 


Command Syntax 


STATION -------- panna nnn nnn nnn enn nnn nnn nn nn nn nn nana -- | 


_ - <bdle-station-name> ------~- - STATUS - 
- COUNTS - 
- DETAIL - 
aie oe 


Response Syntax 


The responses oe described in the following subsections Station 
Summaries, and Station Detail. 


STATION SUMMARIES 


Using the "STATION" form of the STATION command results in the response: 


=> STATION qonn nn nnn nnn nnn nn nn nnn nn nn nn ne nn nee nnn > 
C=- SSeS Se Se eee ne a ae ar em ce ee _ SPSS see SS Ses See sess | 
>-=-<bdlo-sta-n>:i---BDLC DEDICATED ---<status>-------------~-- | 


-BDLC SWITCHED ---| [------ + +- 
~ WITH <neighbor> - 
-BDLC SWITCHED ACU 


where <bd]ce-sta-n> = <bdic-station-name>. 
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Section 9 
Station Summary and Detail Summary and Detail Inquiries 


STATION 


where <status> depends on the station type and is defined as: 
<n ena - ATTACHED a aa a alia | 


-- PENDING ATTACHED --- 


CLOSED ------------- 


PENDING CLOSED ----- 


WAITING ------------ 


This provides a list of each station type, its status, and if it is connected to 
a neighbor, the neighbor identity. 
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Section 9 
Summary and Detail Inquiries 


STATION 


Station Summary and Detail 


STATION DETAIL 


Using the "STATION <station-name>"' form of the STATION command 
results in the response: 


=> STATION <station> ( --- <sta-attr & value> ---) -| 


where <statiion> is defined as: 


--- <bdle-station-name> : -~-- BDLC DEDICATED 


on ae me eee we ee ee ey ee one 


‘|- BDLC SWITCHED 


- BDLC SWITCHED ACU 


and where <station attribute> depends upon the attribute 
option selected: COUNTS, STATUS,DETAIL, OR ALL. 


If attribute list option is DETAIL: 


(the Station Level Manager Station Table attributes are selected) 
HARDWARE = 


<string> 
STATIONTYPE = 


BDLCDEDICATED/ 
BDLCSWITCHED/ 
BDLCSWITCHEDACU 
TRUE / FALSE 
<ensemb]1e-name> 
<ensemb ]1e-name> 


NEIGHBORVALIDATE 


OUTGOINGENSEMBLE 
INCOMINGENSEMBLE 


PERMANENTENSEMBLE <ensemb]e-name> 

NE!GHBOR <host-name> #<node-address> 
AUTOINIT TRUE / FALSE 

LINKSPEED <integer> 

LINKEFFIC}ENCY <integer> 

LINKMAXSEGMENTS | ZE <integer> 

MON! TOR ON or OFF 


LOCALSTATUS 
AUTOCOMMAND INPROCESS 
AUTOCOMMAND INPROCESS 


<enumerated value> 

<enumerated value> 

NULL/ 
ESTABL!SHCALL/ESTABLI SHCALLWI THNNA/ 
CLEAR CALL/ AWAITCALL 
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Section 9 
STATION Station Summary and Detail Summary and Detail Inquiries. 


MANUALCOMMANDMODE = TRUE / FALSE 
MANUALCOMMANDINPROCESS = NULL/ 

OCPD/ 

OCPD <call-data>/ 

CCPD/ 

OsD/ 

CSD/ 

VAL I DATEANDATTACH/ 

DETACH/ 

SENDTEST 
PENDINGOPEN = TRUE/ FALSE 
REMOTEBUSYSTATUS BUSY/ NOT BUSY 
SAVEMARKER = TRUE/ FALSE 


If the attribute list option = STATUS for BDLC 


STATIONDIALOGSTATUS = OPEN/CLOSED/ 
PENDING OPEN/ 
CONNECT! ONPORTD/ ALOGSTATUS PENDING CLOSED 


STAT 1 ONMODE = OPEN/CLOSED 
PENDINGSENDSABM 
PENDINGRECE! VESABM 
PENDINGRESPONSEDI SCONNECT 
PENDINGRESPONSE <integer> 
PENDINGSENDUA <integer> 
PENDINGSENDDM <integer> 
PENDINGSENDDISCONNECT <integer> 


TESTSENDER = RESET/ PENDINGSEND/ PENDINGRESPONSE 


TESTRECEIVER = RESET/ PENDINGSEND 


If option selected = COUNTS for BDLC 


FRAMERECE | VEDCOUNTER 
FCSFAILURECOUNTER 
FRAMESENTCOUNTER 
| FRAMESENTCOUNTER 


If the attribute option ALL is selected: 


This returns a list of attributes and values which are those in Station 
Level Manager's station table entry for that station, plus the accessible 
attributes in the station itself. 
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Section 9 ENSEMBLE 


Summary and Detail Inquiries 


ENSEMBLE SUMMARY AND DETAIL 


This command provides information about the ensembles. There are two major 
forms of this inquiry command: ENSEMBLE and ENSEMBLE <ensemble-name>. 


The "ENSEMBLE" florm returns a list of ensemble names and types. 
The "ENSEMBLE <ensemb ] e-name> form returns the type and station list for the 
specified ensemble. 


Command Syntax 


ENSEMBLE ------- Wen n-ne ----------------------------------- 


-| <ensemble-name> - 


Response Syntax 
The two forms of] response are described: 


Using the "ENSEMBLE" form of the ENSEMBLE command results in the response: 


=> ENSEMBLE (--- <ens-name> : --- PERMANENT----) --| 
- INCOMING - 
- OUTGOING - 


Using the "ENSEMBLE <ensemble-name>'"' form of the ENSEMBLE command results in the 
response: 


=> ENSEMBLE <ens-name> ~-- INCOMING n-ne nmr ene nn---=- > 
- OUTGOING -- 
- PERMANENT - 
Keener een yo moore seco ee- 
Saen=s | <bdlc-sta-name> ---------- 


CANDIDATE Section 9 


Summary and Detail Inquiries 


CANDIDATE SUMMARY AND DETAIL 

The CANDIDATE inquiry command provides information pertaining to the current 
port level candidates. There are two basic forms of the command: CANDIDATE and 
CANDIDATE <port-name>. 


The "CANDIDATE" form returns a list of all candidates with summary information 
about each. 


The "CANDIDATE <port~name>"' form returns a list of all candidates with the 
specified port name with summary information about each. 


Command Syntax 


CANDIDATE ~--------------------------------- 


---- <port-name> ---- 


Response Syntax 


=> Kerem tee em em ewe mmm mem mere 0 Pe eee em ee ew eee ee eee ee eee 
CANDIDATE---<port-name> ----------~---------- (---<match-info>---) ---| 


- [<subp-index>] | 


The subport index (<subp- i ndex>) is returned only for 
local candidates. 
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Section 9 


CANDIDATE 


Summary and Detail |Inquiries 


candidate <match-info> for local candidates are: 


USING PROCESS 
MY HOST 
YOUR HOST 


MY NAME 

MY USERCODE 
YOUR NAME 
YOUR USERCODE 
PROGRAM 
SECURITY 


MATCHING STATUS 


<string> 
<host~-name> 
~-~ <host-name> -- 
pas *xANY 
<string> 
<string> 
<string> 
<string> 
<code-file-title> ON <fami ly> 
~-—~ PRIVATE -eern rors senesnne- 
-- PUBLIC ------------------- 
-- GUARDED BY <file-title> -- 


~-- NOT OFFERED 
~- OFFER OUTSTANDING -- 
-- MATCH FOUND 
-- TO BE CLOSED 
- AWAITING PLM DIALOG - 


candidate <match-info> for remote candidates are: 


MY HOST 

MY NAME 

MY USERCODE 
YOUR NAME 
PROGRAM 


MATCHING STATUS 


<host-name> 
<string> 
<string> 
<string> 
<code-file-title> ON <family> 
~-- INCOMING OFFER --- 
pore MATCH FOUND 
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Section 9 


PORTCOUNTS Summary and Detail Inquiries 


PORT COUNTS INQUIRY 


This command provides information about number of users of the ports. 


Command Syntax 


iineeonachaneceseseoes pte eee eee nnn nnn e eee 
ada ALLOCATED PORTS <--~------- = <integer> ----- | 
> CANDIDATES “o<=-ees<<oce=<< = <integer> - 
~ REMOTE HOSTS “S-=9<<<<s<5+= = <integer> - 


REMOTE HOSTS is returned only in Network mode. 
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Section 9 NET 


Summary and Detail Inquiries 


MODE INQUIRY 


This command provides information about the mode of the node, and the 
initialization file. 


Command Syntax 


NET ------------ pone neo ------------------------------------ 


Response Syntax 


=> --- NOT IN NETWORK MODE ----------------------------------- > 


NETWORK JINITIALIZING--- , INIT FILE = ---<file-title>- 


NETWORK OPERATING --- --SNOCE. aeeeed 


NODE IN SLOW SHUTDOWN 


NODE SHUTTING DOWN -- 


>--- , NEXT INIT FILE = --- <file-title> --------------- 


--- *NULL ------ 
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REPORTS 


SECTION 10 
REPORTS 


This section provides the syntax of the Network Services reports. These reports 
are originated by all levels of Network Services and presented to the Network 
Services Manager for display and logging (if required). This section is divided 
into four subsections: Network Services Manager Reports, Port Level Reports, 
Router Level Reports, and Station Level Reports. 


As mentioned in| Section 1, reports are normally sent to the ODT agent and by 
using the REPORTS + command, any agent requesting the reports. However, it 
should be noted! that the agent requesting reports must have the authority to do 
so. This authority is granted by the Access Control command AUTHORIZE. For 
detail of this command, refer to Section 3. 


NETWORK SERVICES MANAGER REPORTS 


NETWORK SERVICES MANAGER PHASE CHANGE REPORT 


This report is generated when there is a Network Services phase or mode change. 


Report Syntax 


NODE 1S NOW -~---- NETWORK INITIALIZING ----+------ 


IN NETWORK MODE --------- 


SHUTTING DOWN SLOWLY ---- 


SHUTTING DOWN -~--------- 


NOT IN NETWORK MODE ----- 


7 
t 
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REPORTS ee 


MESSAGE FROM A REMOTE AGENT REPORT 
This report is generated whenever a "TO" message is received from a _ remote 
agent. Receipt of this report only displays the message, it has no effect upon 


the node operation. All text within the message is treated for display purposes 
only. 


Report Syntax 
FROM <host-name> --- #<node-address> -- : -- <text> --- 


ROUTING REPORTS 
This subsection provides details of the reports generated by the Router level. 


The reports include error reports, and reports about. changes to network 
topology. 


ROUTER FRAME ERRORS REPORTS 
These are the error reports generated by the Router level. An illustration of 


the general syntax follows; the syntax error name describes the actual error: 


Report Syntax 


ERROR IN MESSAGE --- FROM <host-name> #<node-address> ----- > 
SeScteRt ios TO  <host-name> #<node-address> : ---> 
>--- FRAME UNDELIVERABLE ----~-------------------- 

- TRANSIT COUNT OVERFLOW -~------------------ 
~ MAX SEGMENT SIZE <intgr> EXCEEDS <intgr> - 
- FRAME TOO SHORT -------r errr enn n nnn 
- INVALID FRAME FORMAT, TYPE = <hex-number>- 
~ UNKNOWN FRAME FORMAT, TYPE = <hex-number>- 


V V 
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Section 10 
Reports 


INVALID DESTINATION : <node-address> ----- 
UNKNOWN ORIGINATOR : <node-address> ------ 


INVALID NETCHANGE SUBJECT: --- 


- <node-address> FROM <node-address> ---- 
INVALID LINKCHANGE ORIGINATOR: <node-addr> 


INCONSISTENT MRF = <integer> --- 


- & MHC = <integer> FROM <node-addr> -- 


UNREACHABLE DESTINATION: <node-addr>- | 


< aeweae SFB SBS BB Swern es ene eee ae ee mae 


- FOR TRACE RESULT FROM <node-address>- 


REPORTS 
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REPORTS S oe 10 


ROUTING TRACE REPORT 


A trace operation is initiated in response to a START TRACE command. 
Subsequently reports are generated by all nodes along a trace path, and are then 
delivered to the originating node in the following form: 


Report Syntax 


ROUTING TRACE FROM <node> : ---- REFERENCE NUMBER = <integer> --------- | 


TRANSIT COUNT = <integer> -------- : 


SOURCE = <host-name> #<node-address>- 


DESTINATION= <host-n> #<node-address> 


MY RESISTANCE FACTOR = <integer>----- 
--- REACHABLE ------------------------- 


~ UNREACHABLE -- 


HOP COUNT ----~- = <jnteger> -cw----- 


PATH RESISTANCE FACTOR =<integer> --- 


NEIGHBOR = <host-name>#<node-address> 


LINK RESISTANCE FACTOR =<integer> --- 


Where <node> is the node which sent the report. 
Where <host-n> = <host-name>. 
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Section 10 REPORTS 


Reports . 


DESTINATION NODE STATUS CHANGE REPORT 


This report is generated by the Router whenever its routing parameters change 
for a remote node. ; 


Report Syntax 


ROUTING STATUS TO| <host-name> #<node-address> CHANGED : ----> 
gree renee A p BM e tress serene 
Power rerrese- bao a on a am wo REACHABLE waren er reer teem eee 
~ E |. UNREACHABLE - 


- MAX SEGMENT SIZE = <integer> ---- 


- VIA <host-name> #<node-address> - 


All parameters are returned whether changed or not. The "*" indicates that a 
parameter has been changed. 
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REPORTS ae i 


STATION LEVEL REPORTS 


This subsection provides details on the Station level reports. These reports 
include error reports and status reports that are generated by the Station 
level. The reports are detailed under two categories: Neighbor Status Reports 
and Station Reports. 

The Neighbor Status Reports provide information that concerns’ the_ logical 


connection to the neighbor. The Station Reports provide information concerning 
the individual physical links. 


NEIGHBOR STATUS REPORTS 


In these reports <neighbor> is <host-name> #<node address>. 


Report Syntax 


<neighbor> RESTARTING ---------------9 nnn nnn nnn nH | 


This report is generated whenever a GREETINGS 1 frame is received indicating 
that the neighbor is initializing, and the neighbor was thought to be attached; 
that is, it must be RESTARTING. 


Report Syntax 


<neighbor> DISCONNECTED, NEIGHBOR BUSY TIMEOUT EXCEEDED 


This report indicates that all connections to the neighbor were in a remote busy 
state (no activity for more than NEIGHBOR BUSY TIMEOUT), and have now been 
closed. 
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Section 16 
REP 
Reports Station Level Reports one 


STATION REPORTS 


Validation Failure Reports 


Reports are generated by the Station level whenever a validation failure is 
detected. That is, a call was made, or received by a station, and it could not 
complete the vallidation process, either because of security or incompatibility 
restrictions. 


This may requirel operator intervention or it may be a correct rejection of an 
invalid link attempt. 


lf operator intervention is required, it would be the operators task to 
determine the cause of the validation failure, and correct it. Most likely 
causes would be incorrect NODEPASSWORDs, incompatible software (VERSION 
information), invalid Network Maximum Segment Size, or unknown node address (if 


NEIGHBOR VALIDATE true) . 


Report Syntax 


~-- LOCAL ---- VALIDATION TO <neighbor> FAILED ON <station-name> 


: REMOTE i‘ 


Station Attach! and Detach Report 


These reports are generated whenever the attachment of a station is changed. 
Attachment occurs when the validation process completes, and the station is 
attached to the router queues for traffic. Detachment occurs when the station 
is no longer attached to the router for traffic. 


Report Syntax 


STATION <sta-name> --- ATTACHED TO ----- <neighbor> ------- 


- DETACHED FROM- 
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REPORTS Section 10 


Station Level Reports Reports 


Station Failure Report 
Station failure reports provide information on station failures that occur 
during the station functions: Open Connection Port Dialog, Open Station Dialog, 


or Send Test. Each failure is reported and the <reason> field describes the 
failure type. 


Report Syntax 


STATION <sta-name> FAILED TO <action> BECAUSE <reason> 


The <action> is one of the following: 
. OPEN CONNECTION PORT DIALOG 


- OPEN STATION DIALOG 
- SEND TEST 


Test Reports 

These reports are caused by the receipt of Test messages by a station. Test 

RECEIVED indicates that a remote station sent a Test message, and provides’ the 

text of that message. Test ECHOED indicates that the Test message sent by this - 


station was echoed back by the remote station. No checking of the message is 
made by the station, it is just displayed as received. 


Report Syntax 


TEST --- RECEIVED --- FROM <neighbor> -~-------------------- | 


~ ECHOED --- - 3: <text> -- 


Station Error Report 
These reports are generated whenever the station detects an error. situation. 


The error description is provided in the <station-error-message> of the report. 


Report Syntax 


STATION -- <sta-name> -- ERROR: <station-error-message> 
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REPORTS Section 10 
. _ Reports 


PORT LEVEL REPORTS 


Reports that aré generated by the Port Level Manager are presented in this 
subsection. 


HOST SAVED REPORT 
Report Syntax 


HOST SAVED: <host-name> #<node-address> 


This report occurs when a host actually becomes saved. That is, after a SAVE 
HOST command and all subport communication is stopped. 


PORT LEVEL ERROR REPORTS 


Validation Failure Report 

This report is generated whenever a validation failure is detected. This can 
occur legitimately when an unacceptable host attemps to open a dialogue, or it 
may occur due to some operational error. If this occurs, the most likely causes 
are: an invalid [password, an invalid node address, or an invalid host name, or 


it may be that the HOST VALIDATION is on inadvertently. Operator intervention 
is required to overcome this, should it be desired. 


Report Syntax 


HOST VALIDATION FAILURE ON <host-name> #<node-address> 


Subport Dialog Establishment Failure Report 
This report occurs whenever a subport dialogue management error is detected. 


This should not normally occur. It indicates a logical failure in the port 


mechanism, or that port frames are being received corrupted. 


Report Syntax 


PLM SUBPORT DIALOG ESTABLISHMENT FAILURE 
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Section 10 
REPORTS Reports 


Port Level Error Report 


Errors detected in messages, received by the Port level are reported with this 
report. The error type is described in the report. 


Report Syntax 
ERROR IN MESSAGE FROM <host-name> #<node-address>:; -------- > 
>---= UNKNOWN PORT ADDRESS: <port-address> ------------ 
- INVALID FRAME FORMAT, TYPE = <hex-number> - 


- INVALID SUBPORT ADDRESS:-------- 


~<subport-2ddr> FOR PORT <port-addr>- 
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APPENDIX A 
OIM MESSAGE SYNTAX 


RAILROAD DIAGRAMS 


In this document the syntax of each OIM is presented in the form of railroad 
diagrams. A railroad diagram is a technique used to graphically represent the 
syntax of language elements. Traversing a railroad diagram from left to right 
or in the direction of the arrow heads, and adhering to the limits illustrated 
by bridges produces a syntactically valid statement. 


Continuation from one line of a diagram to another is represented by a right 
arrow > appearing at the end of the current line and the beginning of the next 
line. 


Continuation from one page to another is avoided wherever possible. However, 
where unavoidable, the use“of the right arrow >, and for the case of items 
listed vertically, the inverted arrow v, are used to denote continuation. 


The syntax diagram is terminated by a vertical bar |. 
Items contained in broken brackets < > are syntactic variables which are further 
defined in the appendix, or require the user to supply. the requested 


information. 


Upper case items must appear literally, but where abbreviations can be used, the 
abbreviated items are underlined. 


Example 
K----/3\n-2- conn | 
-- A RAILROAD DIAGRAM CONSISTS OF ----- <br idges>rn nnn nnn nnn nee nnn nnn > 
=<lOOps><=-sS<<=+- 
Vv 7 
"end of the page 
v v 


-<optional items>- 


-<required items>- 
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Appendix A 
fetes OIM Message Syntax 


>- AND IS TERMINATED BY A VERTICAL BAR, ------------------------------- 


The following syntactically valid statements may be constructed from the above 
diagram: 


A RAILROAD DIAGRAM CONSISTS OF <bridges> AND IS TERMINATED BY A 
VERTICAL BAR. 


A RAILROAD DIAGRAM CONSISTS OF <optional items> AND IS TERMINATED 
BY A VERTICAL BAR. 


A RAILROAD DIAGRAM CONSISTS OF <bridges>, <loops> AND 1S TERMINATED 
BY A VERTICAL BAR. 


A RAILROAD DIAGRAM CONSISTS OF <optional items>, <required items>, 
<bridges>,<loops> AND 1S TERMINATED BY A VERTICAL BAR. 


RAILROAD COMPONENTS 


<required items> 


No alternate path through the railroad diagram exists for required items. 
Example 


-- REQUIRED ITEM ~-------------------- weno rene none none nen ne oe - + ----- 


<optional items> 


Items shown as a vertical list indicate that the user must make a choice of the 


items specified. An empty path through the list allows the <optional item> to 
be absent. 


Example 
e= REQUIRED: TEM orn eH S-ee ss Ss ea ees R saa see Sarees eh Seen ter emer Sasser 
-<optional item-1>- 


-<optional item-2>- 
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OIM Message Syntax 


The following valid statements may be constructed from the previous diagram: 
REQUIRED ITEM 


REQUIRED ITEM <optional item-1> 
REQUIRED ITEM <optional item-2> 


<loop> 


A <loop> is a recurrent path through a railroad diagram. A <loop> must be 
traversed in the direction of the arrow heads, and if any limits are _ imposed, 
they are specifiied by bridges. A <loop> has the following general format: 


<--- <bridge> ---- <return character> - 


we--<object of |the loop>---no ncn nnn ener en newer nen nen nnn enna nnnnn 


Example 


Beane <Opliond!. tiem= | Seres Ses ean H se oases Sr eer ean Sses meres eases ahaa 


-<optional item-2>- 


The following s|tatements can be constructed from the previous diagram: 


<optional item-1> 

<optional item~2 

<optional item-1>,<optional item-1> 
<optional item-2>,<optional item-1> 


<br idges> 


A <bridge> illustrates the minimum or maximum number of times a path may be 
traversed in a railroad diagram. The forms of <bridges> are: 


/n\ nis an integer which specifies the maximum number of 
times the path may be traversed. 

/n*\ n is an integer which specifies the minimum number of 
times tthe path may be traversed. 
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OIM Message Syntax 


SSeaS= <optional i temn=l>s~=<<<<+-e>--===<optional items 3e-c- + Sse sss s-- =< 


kazaa i tem-2>- 


The first loop may be traversed a maximum of two times, however, the path _ for 
<optional item-2> must be traversed at least one time. The second loop can be 
traversed any number of times, that is, <optional item-3> can be entered any 
number of times. 


The following statements can be constructed from the previous diagram. 

<optional item-1>,<optional item-2>,<optional item-3> 

<optional item-2>,<optional item-2>,<optional item-3> 

<optional item-2>,<optional item 1>,<optional item-3> 

<optiona!l item-2>,<optional item-3>,<optional item-3> 
Words appearing in all upper case are keywords and must appear as_ presented. 
Words in lower case and embraced in wedges are symbols for user-supplied words 
or values. Where keywords can be abbreviated, the abbreviation is denoted by 
the letters underlined in the keywords. Each keyword, keyword abbreviation, or 
user-supplied item must be delimited from another such word by at least a single 


space or by a special character (for example, parentheses, comma, period, colon) 
defined in the syntax. Redundant spaces are ignored. 


DEFINITION OF COMMON SYNTACTIC ELEMENTS 


<letter> ::= (A thru Z, a thru z ) 


<digit> ::= (0 thru 9 ) 


<integer> :3= ----- <digit> “s==---ss-seeseSsSes—-s eos s< se | 


<character> ::= (any EBCDIC graphic character except quote, 
but including quote- image) 


<separator> ::= ( hyphen or underline ) 
<station-name> ::* <name> 


<host-name> ::* <name> 
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<bdlc-station-name> ::= <name> 


<name> 2:8 wa-mm-ten <letter> cme en nnn o neem meen n nonce nen ne | 


- <digit> oA - <separator> : 


note: 
- upper and lower case letters are equivalent. 
. the separators are equivalent to each other. 
. Names are not distinguished beyond the 17th character. 


<-- <digit> --- 


<value> 238 ----b------ so 1 a a a 


= *DEFAULT -----~- | 


. If *DEFAULT is used for <value>, the default value is selected. 


<response indicator> ::= => 


. This indicator signifies that response syntax follows. 


<quote> ::= ( thle double quote character, " ) 


<quote-image> ::= <quote> <quote> 


<tr ing> (ss= <e= <name> “SseSeeoe oes eeS ere e == seal reat aire 


notes: 
. if a <quote> is to be entered as a <character> it is 
replaced by <quote-image>. 
: arbitrary character strings are embraced in quotes 
to prevent syntactic confusion. 


. *NULL is used to define an empty string. Empty strings 
are displayed in reports and responses. 
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OIM Message Syntax 


The following elements are syntactically equivalent to <name> 
<host-name> <por t-name> <station-name> 


<prof i le-name> <ensemb ]1e-name> <program-agent~name> 


<text> ::= any sequence of EBCDIC characters except those 
used for textual control (for example, on ODTs the 
continue mark, on files the end-of-command mark). 


<node~address> ::= <integer> 


<PEle=Citle>. 228 SS ne eSs se Sesser ee ssee= <Namne>. “-<S<r=+s== > 


- ( <usercode> ) - 


enero di. eassces 
Qe me me me nn eee ee eee | 
Dee ee nn en ee ne eee | 
ane <slash> <name> | \- ON <name> - 
<neighbor> ::# --- <host-name> ~----- norm rrr rr nnn nnn | 


- #<node address> ------------- 


~ <host-name> #<node-address> - 
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OIM Message Syntax KEY WORDS 


KEY WORD REPRESENTATION 


In this document, key words used for commands, inquiries, attributes, and so on, 
are represented in two ways: 


The sia and syntactically correct, is the form of contiguous, upper 
case, alphabetic characters, 


for example: PORTSEGMENTT!MEOUT. 


The other, not syntactically correct, is the separation of the component 
words for |readabi lity, 


for example: PORT SEGMENT TIMEOUT. 
The non-syntadctically correct representations are only used in textual 
descriptions. Error messages, examples, and so on, all use the precise syntax. 
Where all characters of a keyword are not required, those required are 
under lined. E.g-, PORTSEGMENTTIMEOUT, depicted Mngerled below, can be entered 
in the abbreviated form of PSTO. 


PSTO is equivalent to PORTSEGMENTT | MEOUT 
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TIME INTERVALS OTM Meessage Syntax 


TIME INTERVALS 


Throughout this document, whenever <time-interval> is specified, the following 
syntax applies: 


where <hr.>, <min.>, <sec.>, and <fract. sec.> are integers. 
Each time-interval attribute can have a different granularity of time. The 


units of granularity are specified, in this document, by implication of maximum- 
range-units for each command attribute. 


For example, the PORTSEGMENTTIMEOUT command shows the range maximum as 65535 
secs.; this attribute is granular to the second. If the value supplied is 9:5.7 
(9 minutes, 5.7 seconds) then the value used internally is 9 minutes, 6 seconds. 
For example: 


the command: 
PORTSEGMENTTIMEOUT = 9:5.7 


yields the response: 
PORTSEGMENTTIMEQUT = 9:6 


Some useful conversion values: 
65535 seconds = 18:12:15 (hrs: mins.: secs.) 


1440 minutes = 24:00:00 = 1 day 


3600 seconds = 1:00:00 = 1 hour. 
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OIM Message Syntax CALL DATA 


BDLC CALL DATA <dbic-call-data> 
In this document <bdlc-call-data> is defined as: 
ercwenH ' <string> "'--------| 
The <string> is a phone number to be used by an ACU. 
It must appear between quotes. 


It must be a string of characters composed of decimal digits, asterisks 
(x), number symbol (#), hyphens (-), End of Number characters (E), and 
Separators (S). 7 


The decima| digits correspond to HEX digits, the asterisks correspond to 
HEX A, the number symbol corresponds to HEX B, the End of Number character 
corresponds to HEX C, and the Separator corresponds to HEX D. The’ hyphens 
are ignored. 

These characters are used to perform ACU dial operations. Digits specify 
the eeleplone number to dial. Some dialing conventions require an end of 
number (EON) to define the end of the dial operation; the End of Number (E) 
is used for this. 


Where delays between dial digits is required, such as internal telephone 
systems to obtain an outside line, the Separator (SEP) character (S) 
provides a one-digit delay time. On some ACUs the Separator character 
provides a dialing delay but does not put any output on the line, and the 
delay may jbe for one digit time or some ACU-defined time. In either case 
the delay jis used to allow the next dial tone to be present, or provide 
delays required for reliable dialing. 


A maximum of 20 characters, not counting hyphens, can appear. 
Examples 


To dial |the following telephone number (215) 648 4000 
<bdic-calll-data> is: 


"2156484000" or 215-648-4000" 


To dial |the same number from an internal telephone 
system that requires a second dialing tone. That is, 
a delay of one digit time is needed after the first 
digit. The <bdIic-cal|-data> is: 


"9S2156484000" or ''9-S-215-648-4000"' 


Where the '"'S" introduces a one digit delay. 


Delays can be introduced anywhere within the string to 
provide delays suited for the telephone system, and 


dialing procedures. 
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APPENDIX B 
HOW TO PICK MAX HOP COUNT AND MAX 
RESISTANCE FACTOR (MHC AND MRF) 


The values of MRF and MHC are constant within a particular network. The 
selection of these values for a particular network is important and may be non- 
trivial for some networks. This appendix describes what the '"'best"' values of 
MRF and MHC are and gives some idea of their bounds. 


USE OF MRF AND MHC IN THE ALGORITHM 


MRF and MHC are used by the Router in the BNA network to determine 
reachability of a destination node. If a NETCHANGE message is received 
with Snes (resistance factor + linkrf >= MRF) or (hop-count + 1] >= MHC), 
the subject node is marked as unreachable over the link on which the 
NETCHANGE ‘was received. 


THE "BEST" SIZE FOR MHC AND MRF 


The "best'! size may have different meanings for different people, but one 
definition is the following: 


MHC and aa are the smallest value such that any possible physical path in 
the network (without entering a node twice) between two nodes has (hop- 
count < MHC) and (total resistance-factor < MRF). 


COST OF MHC AND MRF BEING TOO LARGE 


If MHC anavyor MRF are too large (larger than the "best'' value), more 
NETCHANGE messages may be exchanged among the nodes than with the "best" 


value. How many more depends on how ''too large'’ the values are and upon 
the network topology. 


COST OF MHC AND MRF BEING TOO SMALL 


1f MHC and/or MRF are. too small, (smaller than the "best'' value), 
artificial) conditions of unreachability are introduced, that is, there 
exists a physical path between two nodes, but both of the nodes. believe 
that it does not exist. (NOTE: this may be considered a feature by some 
network designers. For example, although there are physical paths of up to 
20 hops, the network designer may not want any dialogues to be established 
with a hop-count of more than 8.) 


BOUNDS ON MHC AND MRF FOR THE "BEST' VALUE 


Clearly, the smallest either MHC or MRF can be is 1. Given a network with 
N nodes, the most that MHC can be is N, because a path may not go through a 
node twice) An upper bound on MRF is the sum of the highest N-2 node 
resistances, plus the highest N-1] link resistances in the network. However 
in many capes the upper bound is not the "best'' value, particularly MRF 
(see example.) 
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Appendix B 
a MHC and MRE 


The process of selecting the "best'' MHC is roughly equivalent to the 
process of finding a path which goes through each node once and only once. 
The process for determining MRF is more difficult. Both problems can only 
be solved completely by an exhaustive search of all possibilities. 


Example ; 
+----- + +----- + +----- + 
100 100 100 
B 
+----- + +----- + +----- + 
| 200) | 
200 | | 200 
+----- + +----- + +---~- + 
100 | 200 10 Jenene 100 
A alate === E 50 “on 
+----- + 50 5 eleteetentae + 200 +----- + 
S seteantoate + 200 | ---+----- + sheen ne +--- +----- + 
100: [| =S<o=5= 10 10° ([aa==<<== 100 
Co eesen= D 200 
+----- + lle Setanta + 50 +----- +--- +----- + 
 eaettate + 200 200+----~ + 
| 100 a y | 100 | 
eon n + +----- + 
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(a link of link resistance = 200) 


(a node of node resistance = 100) 


Upper bound MHC = 12; actual "best" value = 5 


Upper bound MRF = 2810; actual "best" value = 531 


Appendix B 
MHC and MRF 


The upper bound 


not a good choi 


any other node 


The actual "bes 
between any two 


of MHC is the number of nodes in this network. It is certainly 
ce; there is no possibility of taking 11 hops from any node to 


‘in this network. 


t'' value is chosen because the maximum number of hops 
nodes is four. For example: If the link between C= and 


broken, the number of hops between A and B becomes & (A to C, C to D, OD 


and E to B). T 


hus the "best'' choice for MHC is 5 (4 + 1). 


Of course 5 need not necessarily be the value chosen, as there may be 
factors to be considered. There are cases where a lower hop- count 


suffice, such a 


s if all nodes are not required to communicate with each 


Also, in the example shown above, if the broken link condition could not 


(very unlikely, 


|; however), then a MHC of 4& could be used. 


The choices for MRF are made in a similar manner. 


taken 
E is 
to E, 


other 
would 
other. 
occur 
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APPENDIX C 


GENERAL INDEX, ALPHABETICAL ORDER 


This index includes Commands, Reports, Error 


ACURSPTIMER . 2. 2 6 6 6 2 0 oe ww ww 
ADD CONNECTION . 2. 2. 2. ee we ew ew wwe 
ADD ENSEMBLE . . «1 6 « © © ww we ww 
ADD HOST . 2 6 ee oe 6 ww ww we ow 

ADD NODE . 6 6 0 ee we se 6 we es 

ADD PROFILE . . «. «© 2 6 © 2 ww ww 

ADD STATION... «© © «© 2 ew ww 

ADDED STATION... . 

ALL REQUIRED ATTRIBUTES NOT SET . 


ALL REQUIRED ATTRIBUTES HAVE NOT BEEN SET : 
ALL REQUIRED ATTRIBUTES HAVE NOT BEEN SET . 


ALL STATIONS IN ENSEMBLE ARE CLOSED . 

AT .. 

ATTRIBUTE INCONSISTENT WITH STATION TYPE. 
AUTHORITY CANNOT BE GRANTED OR REMOVED. 
AUTHORIZE .... - aes. 


AUTOENTT teste cee BS oe oS es, Be eed 
AWAIT.CALL BY .. Boga te 

BOLC FAILURE ON Setation> i oe Ae Mee BS 4 
CALL DATA NOT REQUIRED. . ......es 
CALL DATA REQUIRED. . .......2. 26. 
CANDIDATE sco ee WS ee 
CHECKPOINTTIMER at Wee. Sea 
CUBAR HOST (6-8: veces @. ee er A. er OR an 
CLEARCALL: 2 25-e oo SB “e en ac we, a 
CLOSE CPD or SD... ae ar Sen aes Bite 


COMMAND OUT OF SEQUENCE , 

CONNECTION IN USE . ae Jigs a? ler hk Se 
CONNECTION IN USE... ..... 
CONTINUE . 2. 2. 6 «© 2 wee 

CPDMON!ITOR a eae a ae ee ee ee 
CTSRSPTIMER « « 2 6 6 6 te et 
DATARATESELECTOR ...... + wees 
DCDOFFDELAYTIMER . . 1... 6. 2 + we we 
DEDICATED s. 0: 6 ee ee ee wa ee 
DELETE CONNECTION . . . 2. 2. 1. 7 © we we ow 
DELETE ENSEMBLE . a ae 


DELETE HOST 4.0 6 6 8 woe «ew © 
DELETE NODE . . . 2. 6 wa ee 
DELETE PROFILE . «2. «© 0 ow ew © ww wo 
DELETE STATION. «46 6 6 6 wee 4 
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responses, and Station attributes. 
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DELETED STATION NOT IN ENSEMBLE . 
DETACH 


DI ALRESPONSETIMER Pe ee ee ee 

DIALRETRYCOUNT ..... 

DISCARD... : 
<neighbor> DISCONNECTED, “NEIGHBOR BUSY “TIMEOUT EXCEEDED : 
DPRDELAY TE UMER~ 5. ce: 65 ee cee tee ee ae, SS ee, er te a SS 
DSRRSPTIMER + 4% Re et ay Ee oe. es SN 
DUPLICATE AGENT NAME. 

EFFICIENCY ... 

ENDINITIALIZATION . 

ENSEMBLE 


ENSEMBLE ALREADY ADDED. 

ENSEMBLE IN USE 

ERROR !N MESSAGE .. . 

ERROR IN MESSAGE FROM . 

FRROR . « +» 2 + » ‘ 

ESTABLISHCALL .. . 

FCSFAILURECOUNTER .. . 

FILE ALREADY SUSPENDED. 

FILE LOADING IN PROCESS . 
FRAMERECE!VEDCOUNTER. 

FRAMESENTCOUNTER. 

FROM ... ‘ 

FRSPT I MERLONG : 

FRSTIMERSHORT . Be AS Sel Wes Se ele ee ae a 
HARDWARE Poe ae er tae ee ee a a ee ae 
HN 

HOST > tone A oe 

HOST ALREADY ADDED. 

HOST NAME . 

HOST NAME . 

HOST NAME .. . 

HOST NAME DOES NOT MATCH. 

HOST NOT DELETED. 

HOST SAVED. . 2 wy ee 5 
HOST VALIDATION FAILURE ON. Se erode ty 
HOST INACTIVEDISCONNECT 
HOSTINACTIVETIMEOUT . 
HOSTUNREACHABLET | MEQUT 
IFRAMESENTCOUNTER . 

ILLEGAL PASSWORD. a 

IMPROPER ENSEMBLE KIND. . 

IMPROPER ENSEMBLE TYPE. 

IMPROPER ENSEMBLE TYPE. 

IMPROPER FILE FORMAT. 

IMPROPER PARAMETER. 

IMPROPER PHASE. ‘ . 
IMPROPER SETTING OF STATION ATTRIBUTE . 
IMPROPER STATION KIND Cas 


WF H= MN ODNMWN SFE 
' 
nN 


eB 25 
a en | 
~ 5 - 11 
~ 5 - 13 
~- 8 - & 
. 10- 6 
~ § - 13 
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. 3 = 23 
~ 5 - 24 
~. lO- 2 
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~~ 5 -12 
~ 5 -12 
- W- 2 
~ 5 -7171 
~~ 5 -7171 
- 5 - 8 
~ 1° 5 
~ 9 - I 
~5 - & 
- 5 - 5 
> ae 
> ae | 
~& - 2 
«bo = 5 
. 10- 9 

10- 9 


Appendix C 
General Index 


Appendix C 
General Index 


IMPROPER STATION TYPE . 
IMPROPER STATION TYPE. 
INCORRECT PARAMETERS. 


INVALID AUTHORIZATION OPTION. . 


INVALID HOST INACTIVE TIMEOUT... . ° 
INVALID HOST INACTIVE DISCONNECT OPTION ‘ 


INVALID HOST NAME... . 
INVALID HOST NAME .. . 


INVALID HOST UNREACHABLE TIMEOUT. 


INVALID LINK RESISTANCE FACTOR. 


INVALID LOGGING OPTION. 
INVALID MAX HOP COUNT . . 
INVALID MAX PROGRAM AGENT 


VALUE . 


INVALID MAX RESISTANCE FACTOR . 


INVALID MONITOR OPTION. 


INVALID MONITOR TIME INTERVAL . 


e e e o 


INVALID NEIGHBOR BUSY TIMEOUT VALUE. . 
INVALID NEIGHBOR GREETING TIMEOUT VALUE 
INVALID NEIGHBOR RESTART TIMEOUT VALUE. 


INVALID NETWORK MAX SEGMENT SIZE. 


INVALID NODE ADDRESS. . 
INVALID NODE ADDRESS. . 
INVALID NODE ADDRESS. 
INVALID NODE ADDRESS. 
INVALID NODE ADDRESS. 
INVALID NODE ADDRESS. 


INVALID NODE RESISTANCE FACTOR. 
INVALID NODE UP TIMEOUT VALUE... ‘ 
INVALID PORT COMPRESSION ALLOWED OPTION : 
INVALID PORT LOG TIME INTERVAL. 


INVALID PORT RESUME READY FACTOR. 


INVALID PORT RETRY LIMIT. 


s 


INVALID PORT SEGMENT TIMEOUT INTERVAL ‘ 


INVALID PORT WINDOW SIZE. 


° 


INVALID PROFILE REFERENCE... : 
INVALID PROGRAM AGENT SECURITY OPTION ‘ 


INVALID REMOTE HOST . 
INVALID SLM PHASE... 
INVALID STATION ATTRIBUTE 
INVALID STATION ATTRIBUTE 
INVALID STATION NAME. . . 
INVALID STATION NAME. . . 
INVALID STATION PHASE ON 
INVALID STATION 

INVALID TRACE DESTINATION 
INVALID TRACE SOURCE. . 
INVALID USERCODE. ... 


LAST REMAINING STATION MAY “NOT BE 


LINKRESISTANCE 
LOAD 


VALUE 


NAME. 


DELETED . 


e ° e e e e a e e ° e e id e e ° 
EP Pw rr rrmnn Swann 
' 


INDEX-1 


it f 
nN 


t 
Nh Ro 


t { 
— NO 
ON Cn WwW UTW ww ®D O™ bh 


i | 
— —_ 
~ Wn 


C-3 


Appendix C 
General Index 


INDEX-1 


LOCALIDENTITY . sh = 
LOCAL VALIDATION TO <nei ghbor> FAILED ON. eevatian>. e O'S “7 
LOGCOMMENT es. ae bine es Je a Ce Sat Se ‘ - 6 -12 
LOGGING... Pe ae ee eae ae k= 7 
MAX SEGMENT SIZE ~5 - 9 
MAXHOPCOUNT . . . 1... 2. we @ i Hh 12 
MAXPROGRAMAGENTS ....... . 3 6 
MAXRESISTANCEFACTOR . . : ‘ ~ & -12 
MESSAGE TEXT EXCEEDS MAX SEGMENT SIZE ~ 6 -1h 
MISSING NODE ADDRESS. es oe 
MODIFY CONNECTION . ~ 5 $30 
MODIFY ENSEMBLE ~ 5 -25 
MODIFY STATION eo =2) 
MONITOR > 5 = 9 
MONITOR . ~ 4 - 
NEIGHBOR... ee 
NEIGHBOR |S NOT A NODE. +: 5 +26 
NEIGHBORBUSYTIMEOUT .. . ~ 4 -24 
NE!GHBORGREETINGTIMEOUT . ~ & ~-2h 
NEI GHBORRESTARTT | MEOUT ~ & -13 
NET . s 3-2) 
NET os Mew é cee od 
NETWORKMAXSEGMENTS | ZE ‘ a ee ee ~~ 5 
NETWORKVERSION .... Oe ie ee ~ 4 5 
NO CALLS WITH NEIGHBOR EXIST. a a ee -6-4 
NO FILE BEING LOADED. ... - 8 - 3 
NO MORE THAN TWO PROFILES MAY BE “SPECIFIED. ~ 5 -19 
NO STATION AVAILABLE. ae ae ee ae - 6 - 2 
NO STATION AVAILABLE. Go. 7 
NO SUCH <entity> . » 1 715 
NO SUCH CONNECTION. ~- 5 -30 
NO SUCH CONNECTION. ~ 5 -29 
NO SUCH ENSEMBLE. ~ 5 -2k 
NO SUCH ENSEMBLE. a ne ee ee ee ee eee ~ 5 -25 
NO SUCH ENSEMBLES: 4. ces a tds We Jee, Al ca oe ok A 6 =~ 2 
NO SUCH ENSEMBLE 02 a %s. 00 Sw ee Swe Sw ~6- 4 
NO:-SUCH ENSEMBLES. sec s5t “el a. etae: 60 Cayo er tw ~ 6-7 
NO SUCH HOST OR NODE. - 6 -1h 
NO SUCH HOST OR NODE. » 3 = 3 
NO SUCH HOST. . . ae ee er a ee ee ee ae tack! 2 
NO SUCH REMOTE HOST HO fs. a, Gs on ee ESE, Ge, RS ES Ss HO eT 
NO SUCH REMOTE HOST « ok 6 6S OER wR Oe ER SE OO TO 
NO, SUCH REMOTE HOST os «ews oe: ee we WW ew ee a ww Se GHP] 
NO SUCH STATION GROUP... 1. 1. « «© © «© © we @ we ew ew ew ew ew te OH = 2 
NO SUCH STATION . a eee a So - 6 - 2 
NO SUCH STATION . .6-7 
NO SUCH STATION . i a) Je” Se ies He te -6-4 
NO ‘SUCH -USERCODE «: 4s sie Boe Ge es e.g 0) 
NOMSUSPENDED FUME <4 Wp ous he ew eH ~8 -5 
NO SUSPENDED: (PPLE? 2 os. es ee wl ae ear Go -~8 -4& 
NODE ... Ma Le BS ie se ae es See a ta Be ake as a ~-9 -4 
NODE ALREADY “ADDED. pte a ie, ee al ee, Sw SS, ee OE OK ~-5 -& 
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NODE ALREADY DELETED. . . .« «© «© mw 1 © © © © ow 5 - 7 
NOUE: 1S NOW. tse ao ws ei a we a ee EL 10- 1 
NODE NOT DELETED«: «os «M6 a Ge WP a ee a we 5 - 7 
NODE: NOT DELETED: «6 so -e ew ce ee 4 eee ee : 5 - 7 
NODE UNREACHABLE. . . 1... 2. - «© «© «© : es 6 -14 
NODEPASSWORD ....... ‘ : Be ai we . : 3 - | 
NODERESISTANCEFACTOR ....... By a Se ae ‘ 4 -13 
NODESUMMARY: wc: eo a ec ste Se me OR ce ee ee ee Be a oe Ge ‘ 4h ~26 
NODEUPTIMEOUT . . . 1. 2. «© «6 © © © © @ 62 St @ k ~~ 1k 
NOT DELETED: 3) 6 2 ee. ee ww 5 -20 
NOT DELETED 6) BM oie. 8 we oO 5 -20 
NOT: (DELETED o505 coe ei we Oe a a We a we ae aS 5 -20 
NOT IN NETWORK MODE... . a ee ee ae 1-14 
<file-title> NOT PRESENT FOR LOADING. Go es Oe Sooke Si .2 
NW... < ° ° ee RS Bo te eR: cae 1 -10 
OPEN CPD. or SD. <. 7 - 1 
PLM SUBPORT DIALOG ESTABL1SHMENT. FAILURE. 10- 9 
PORTCOMPRESSIONALLOWED ..... i os 4h ~17 
PORTCOUNTS. .... ee ce aY Set he SOs lor es, ae 9 -20 
PORTLEVEL INCARNATION . ee eh ee Sa aa kh ~ 3 
PORTLOGINTERVAL 6 so :8 See oe ee A aS we eS ewe ee eH eT 
PORTRESUMEREADY . 5 2. 2 2 0 ee ew ww ew ew ew we wt ww wl lw & 18 
PORTRETRYLIAIT: -2-426 fk. Sa Ae Set OR ae we Oe Se TB 
PORTSEGMENTTIMEOUT . . 1 2 1 2 0 eo ew we we ew ew we ew ew ew ew ew ew BOG 
PORTWINDOWSIZE: <-> so co: ca nh, che Bie ok ee te a Se Be ee - 18 
PROFILE... Se. Bee di vg, nto 2S, eds Eas Se) pay See “Gr cee So a ae 2 
PROFILE ALREADY DEFINED tee oP ase eh ar es 2S Se. ei fe a SSS 
PROFILE NOT DEFINED... ... 5 2 «© « 5 -17 
PROGRAM... . eB uel es Ee Sen Be Ge ce 3 - 9 
PROGRAMAGENTSECURITY | Oe. Oe Ae cb cw “as GS 3 - 8 
READY. HOST va se-Ge-2S Se. ce Ee, Ee ees “8 6 -10 
READY <<STATLON 3. a: ce ce, Mar sar Oo ee re. Soe ees Pe 6 - 8 
RELEASE - eo «<6: eo aE: a! See Geo ES ee 1 -16 
REMOTEBUSYMONI TOR a eo Ak GE RR Ee ee Se 5 -13 
REMOTE VALIDATION TO <neighbor> F FAILED ON <station> . 10- 7 
‘REPORTS .... ‘ i ces be ae See Ser Oe Eee 1 -~16 
<nei ghbor> RESTARTING ; 10- 6 
RETRYDELAYTMER: «ss 4: -@ 4S So we wa we a OS 5-14 
RETRY LIMIT GHEGRET. «3 cor nek ce 5 For es HS he Se a Se Oe 5 - 9 
~ RETRYLIMITSABMDIS . 2. 1. 1 6 ew ew ew ew ew te we tw te tl 5 -10 
ROUTER VALIDATE IS FALSE. . . . 2. 6 2 © © © w © ww 5-4 
ROUTERHEADERSIZE « «8 © 4 4 6 @ #0 8 @ 6 ee we < ~ 4 ~ 3 
ROUTING STATUS TO... 2... © « we we ow ‘ ae » « W- 5 
ROUTING TRACE FROM ...... e - W- & 
ROUT INGREFRESH. a: te? ae Oh oe ier ee chee . 6 -12 
ROUTINGS Gu & o-Ge ko Bee Os ee 9 - 8 
SAVE “HOST. > wa, hs ae es SE ee ee ne A 6-11 
SAVE™STALUON : Sex 4 Bese, Mar SB sels oe eh Se ie: OAS ae DS oi ee a we we BS 
SELECTSTANDBY . 2. 6 6 0 6 0 ew ew ow eo ww we oe we ee we wh wh eh ew SAND 
SENDTEST ... bE. Ge a ‘ 7 - 1 
SHUTDOWN CANNOT BE “CANCELLED. Sy ews eel ee cw ee ae, ee 2- 3 
SPEED ie “eee He ar ‘a Ge cat pais Wo ads Wh CBee a> a ae ke te 5 - 9 
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STARTERACE Jas Je 2 ee eet a ak ae ee, Ga we ge a BSS 
STEALION | oe - ch a. Bo a ee cae cP ig ee eS AAG GS et oo ee Set TOS 7 
START ON: we: ig. sé et eas tas ee tee Be ee A ee 2 - Se ee, es Be ee we 1 8B 
STATON a. &: Se cpa Ue OW vee Se he. BS SO ae fe ke ee, ee TDS 
STATION Gt Oe AES es Qe aia nie ak te RS ca On OD AS 
STATION ALREADY CLOSED. a gee <e Bae 0) ee Ge a was - & 


STATION ATTRIBUTE MAY NOT BE SET. 
STATION FAILURE ......... 

STATION FAILURE... . 

STATION NOT AVAILABLE 

STATION NOT AVAILABLE 

STATION NOT CLOSED. ... ‘ 
STATIONS IN ENSEMBLE NOT OF PROPER “TYPE . 
STATIONS IN ENSEMBLE HAVE NOT BEEN ADDED. 


STOP - 3 
TEST o- 8 
TO oF 
TRANSITCOUNTLIMIT. . 

TUNINGS . -25 


UNAUTHOR! ZED AGENT. ela se & EO 
UNREACHABLE TRACE DESTINATION: 
UNREACHABLE TRACE SOURCE ee 
USERCODE MAY NOT BE SPECIFIED . 
VALIDATE .. F 
VALIDATE OPTION INVALID . 
VALIDATEANDATTACH .. . 
VALIDATION FAILURE ON . 
VALIDATION FAILURE. 

VALIDATION FAILURE. 

VERSION . : 

WINDOWS 1ZE 
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COMMAND INDEX, ALPHABETICAL ORDER 


ADD CONNECTION .. 
ADD ENSEMBLE .. 

ADD HOST .... 

ADD NODE . 

ADD PROFILE . 

ADD STATION . 

a a 

AUTHORIZE .... 
AWAITCALL BY .. 
CANDIDATE . 

CLEAR HOST 

CLEARCALL .... 
CLOSE CPD or SD... 
CONTINUE .. «ee - 
DEDICATED ..... 
DELETE CONNECTION . 
DELETE ENSEMBLE . 
DELETE HOST. . 
DELETE NODE ..... 
DELETE PROFILE ... 
DELETE STATION 

DETACH ... 

DUSCARD: -« <6. 6 6 
ENDINITIALIZATION . 
ENSEMBLE ... . 
ESTABLISHCALL . 

HN: 6 eo a wee 

HOST 9 6c!a) @ ei 


HOST INACTIVEDISCONNECT 


HOSTINACTIVETIMEOUT . 
HOSTUNREACHABLET | MEOUT 
LINKRES!STANCE 

LOAD .... ee 
LOCALIDENTITY . . 
LOGCOMMENT ..... 
LOGGING . . 2. 2. ws. 
MAXHOPCOUNT . ... . 
MAXPROGRAMAGENTS . . 
MAXRESISTANCEFACTOR . 
MODIFY CONNECTION . 
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Command Index 


MODIFY ENSEMBLE . 


MODIFY STATION - 21 
MONITOR . - 9 
NEIGHBOR ... ; -~ 4 
NEIGHBORBUSYTIMEOUT . .. ....... 0. - 2h 
NEIGHBORGREETINGTIMEOUT . .. 1... ee - 2h 
NE 1 GHBORRESTARTT | MEQUT An sig Ml dip cis ee 1k. Ses - 13 
NEG cg, gute cadre ney ce: oe ween Bd, we ket: te Te Ok See Ue - 21 
NET ce. erat - 1 
NETWORKMAXSEGMENTS | ZE - 5 
NETWORKVERS | ON - 5 
NODE? ce. cabs: ae ietot: et eek we oh oe - 4 
NODEPASSWORD . 7... ee ee - ] 
NODERES1 STANCEFACTOR | - 13 
NODESUMMARY . . - 26 
NODEUPTIMEOUT . - 1h 
NW - 10 


OPEN CPD or SD. s 
PORTCOMPRESS | ONALLOWED | 
PORTCOUNTS. . .. 
PORTLEVEL INCARNATION 
PORTLOGINTERVAL . 
PORTRESUMEREADY . 
PORTRETRYLIMIT 
PORTSEGMENTT | MEOQUT 


PORTWINDOWS!ZE By SM. Gee hey wee - 18 
PROPUEE: veel eae Be wr Se Siw. he tee = 12 
PROGRAM... oe ee ee ee ee ee a 
PROGRAMAGENTSECURITY - 8 
READY HOST. .. = Oe * 
READY STATION . ae a a ee - 8 
RELEASE: 6: si c¥: ek GR Se we - 16 
REPORTS . - 16 


ROUTERHEADERS | ZE_ 


rNww EHOW HR~IDMDW DEH HDDAWWDO PPP PP rwo rs rer rwo PF Prnwo rr Prwo Frm 
' 
oo 


ROUTINGREFRESH. = 12 
ROUTINGS . - 8 
SAVE HOST . =] 
SAVE STATION = 9 
SENDTEST an 
STARTTRACE = 3 
STATION a : : ‘ : - 13 
STOP : . = 3 
TO -e Ss . oe : es oe : - 14 
TRANS I TCOUNTLIMIT : & Ba as = a 
TUN ENG Sse te eS ee te bat ee ee a A = 25 
VALCO ATE ei Gn ie i Sar RR ec ES ae SOR ee Ge - 6 
VALIDATEANDATTACH . - | 
VERSION . - & 
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APPENDIX E 
COMMAND INDEX MNEMONICS, ALPHABETICAL 
ORDER 
ROBY & ck ccc ee Ro ee hs EG he Seeds Aes, Hee, BS 6-1 
ROD CONN. oe: ee ae cat. 6c ret pc se> er te ah, es te aie a Eee ce! Se he 5 -26 
ADD ENS ar oe ee i i ee Hae el eee Ee ere SOS 5 -22 
RUD HOST). 6 cae ate wi ee oe, BOR. RE Te et ys Re a a GS 5 - 3 
ROD VNOD Es: es cde ee Se hee Pe: Ca Se SE be BO ee 5-4 
ROD: PROP 6: tet oe <a: Se. Sor, MS ee Ws ww a ie, Ee ae SS We SE 5-16 
WOODS SA a? 6+ ee ae o> Oh he Hes ta, Va cl ED A as Se Ss ee Sw es 5-18 
Bie, ve: See ee esi“ Re Ss ct ee Re RE eS we Cae el et Vee SR a a 1- 6 
BAIT has ce: 268 a cw, Hh en ae Se BL. A oR a ER RE ee ae Be, BG 3- 4 
CAND Ss. fo. ce? oR ie ree ew wh tes SE Se ey en ee es A Se 9-18 
Ge “el ee, Be es oar ae tee cee tes MO A GE So we ie A 63 
GUAR HOST 39. so 2a- Jn. sol enadi Qe 4d SS Mike Bo Ww weed LH 6-10 
CLOSE. CPD Gib Ste ee ay vei. ae fee er im ae kt oe, Se a es i= 4 
CONT es de cs ak oe Ger SS RE Ss a he eR ge > Ae ee Se we we 8- & 
DED® 5.) 2:2. 40 Sa a Bae UR at ae AS eet a SR i a ck, Se Re, ol 1-1) 
DEL. CONN 6. i oe. eel) Ai ae ie Se ea Se ee ae eh ete ae ce sh swe SO 5-29 
DEES IENS: << <3 eee Ge: ae ye OR es tes ca aa ae ke Ge at Ue Se. Ge eet te ee, Se ig 5 -2h 
DEE HOST s wee. Ge eo ee eS e. S. ee Oh  S te s Se ae es WS 5- 5 
DEL INODE fe mig tae, a Vie DO a hee a Sg ak a ey ecw ae SG. H 5- 6 
DEG VPROP GS ve ole cee Be kt ae erat ee ae aes oe Sg AS SA Ca ee 5-17 
DEL SEA: a cece Se a Se sie SS ka a a ee Ge mw ce i! ek ea we GE, 5-20 
DEW a>. te sah Saha net Sec te es SP Ae Ee tS He a a Al ye > ae oe Y ae 
DESCARD uc ete. Be ide bs Ge as et a Se ae i ae Se ee 8- 5 
BG yo ve Ae Sah SE ae Ne es Ge. Be ae te: “A ok we Bie at a Ee, Be 6-4 
END. ce cele ner es eke ec a ee a ae ae eR a SL ee 2-4 
ENG (9.0% ce: Gi. te “eee eo eee, et Se “ne a ee Se OS Gee oe cas Sele ae oa 9 -17 
PUR eae Se tes ee, sie CEN eee ee Gas Gt Vig cide hb, ees TE SRN Vee IS“ Se eae Ca 4-2) 
PET er. ohn 4. gr Os a Bion WE > Ae “Ge ne doe Ke “Se GS, ce URS Been Ge. de 4-2) 
PINGS. re 3 en Qi at ned ge’ ena Oe Se eh re: Cie 8k ee et Ce: Fenn tes te” re ee es SE Od 5 
HOS Ts te 2s we tac the Sessa, fog OP eds od Fe erences ae hk a, a gs 4 
PUTO se cos. ee tae eS Gee! ah ce ee hg 9). aL de re Se es SA es =e A hk - 22 
LC ie Se So" hes abs Sp, al lat Bia cths tal ica de> gee. ar GS lay em 6" eg! dee 6 -12 
LOADS. 6. a ieee Wee) 1S eee eG ee. a) es “Re ee eR CR Ee we Gh 8 - 1 
OG. oy 6. sasha a4 to ce So i Sole eat A a ee ee ds 2, edt se. Bl ee k- | 
OLE hee Se. So eh ac we es ne: ones oer hes BR Pea: we oS k- 7 
LRiee. Sa 2 a eA SS eit le ee Sel Se %5 a a Be a Rew, a8 L -16 
MAXPROG: «00 feces ee Oe ok” 8 se ae ae a he Sar be eee a OE: Ve aa 3 - 8 
PAG) ee ci els ae Sek hS- G6 Be te ee de MO? De hats ee Re ee Ue Se ad ee a at kh -12 
MOD’ CONN. eos) taba Sw ee se ir is Gee ee Che a as 2 ae ae ae 5 -30 
POD ENS \o. ceo Sb el el ee i Oe a Se Oe le Ses ee we Sg BORZS 
POD SGA ae ig’ ks ap ces er le ae er te, eo A @ SG ae we oe RO 5-21 
BRON de “ah io im nas ae abe Soe a ay 8, al Te ee Ge GE “Ge a a k- 9 
PRR, ar fat: ne A hn set fe Ss 8 we aa na Ss A Se NA es ge BR 4k -12 
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Command Index Mnemonics 
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NBTO. 2. 2 s 6 6 we 0 @ * - 24 
NEI oe ee ee 7 

NET 2 0 we 6 we we me ew ww we 

NET oo 6 we oee et Se ye. pe wt eG) Se, ae 

NGTO> fo: ee Sw wee ee a ee ee 

NODE 5, ene eta ae Se ee a at ks Vere ch Sr 
NODESUM: vex 04 26. Sere: es ela ee a, Rn ee Be 
NPW. 6 0 ee ee ee te we ww hl ht 


PCA . 

PLI. . 

PLINC . 

PORTC . 

PRL . 

PROF. 

PROG. . . 

PROGSEC . 

PRR . 

PSTO. 

eg ae ee ee a 
READY ‘HOST oe a @co¥. we es 
READY STA . 

REL . 

REP . 

RHS ... 

ROUT. .. 

RREFR . 

SAVE HOST . 

SAVE: SPR, <td ee eo hs tae SS Ga ae A ee: Ac ht A oy a OE 
SEND TEST ee: ace aa el She: epee Ee a Eye a Ss Sew at Ge & @ 
STA ee 4 e 6 

STARTTRA. 
STOP. 


TO. 2 & 

TUNINGS . a 

VAL woe oe Oe are a on 

MALT eo see ase a es ek SP ae. p> ass me naw eos ah bao el a ee 
MER coe tert tae a acer ca GSS: ap JA Qi. ge tie dar aah An: eka at 


° ° a e ° ° ° ° e e ° e od e e ° ° ° ° o. e e e e e e e ° ° e e e e e e oo °° e e J e e e 
ENAW EHD SE ORNNAIARMHWO FH H— HDL KWWwlO FW rr esr rrrwFrw Fwonwd 
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APPENDIX F 
ERROR MESSAGE INDEX, ALPHABETICAL ORDER 


ADDED STATION. ... eh ee Gee WS od a a Ce a BSE 
ALL REQUIRED ATTRIBUTES NOT SET i es nde Ob aes as ee Be Wes BBE 
ALL REQUIRED ATTRIBUTES HAVE NOT BEEN SET... ...2. 2-2-4 
ALL REQUIRED ATTRIBUTES HAVE NOT BEEN SET... 2... 2.2. 17195 
ALL STATIONS IN ENSEMBLE ARE CLOSED .......s.s-se eee 6-4 
ATTRIBUTE INCONSISTENT WITH STATION TYPE. . ... 4... +. 5719 
AUTHORITY CANNOT BE GRANTED OR REMOVED. ...... 2+. + - 3- 6 
BDOLC FAILURE ON <station>..... te So es ew ew tee oe Pg 
CALL DATA NOT REQUIRED. ... 1... 2 ee ee eee ee te e OH J 
CALL: DATA REQUIRED. 6% so-o @o we ls ee te a Se ED 
COMMAND OUT OF SEQUENCE . . 1 6 6 ee ee ee we te ee ee JB 
CONNECTION IN USE ..... — 5-29 
CONNECTION IN USE. 2... Baca age Gas BE PRT hs GO te ue ae BBO 
DELETED STATION NOT IN ENSEMBLE basi ee ak ao Bk we BEE 
DUPLICATE AGENT NAME. ... ei vide ober, TE DLE ee he oe Fa ee ae SEP] 
ENSEMBLE ALREADY ADDED. . 2... 1 ee ee ee ee ee we 5723 
ENSEMBLE IN USE... . 2. ee ee we ee we ew ww ew ww ew SF HOH 
ERROR? Scie see Bee eae dit Sots Se eh al eS ea pe Ve? Ss ee we 8 
FILE ALREADY SUSPENDED. .......- . . B- 3 
FILE LOADING IN PROCESS .......+.+2e-. ; .8- 2 
HOST ALREADY ADDED. ... rau aie cist was Ot ees a ~- 5-4 
HOST NAME - NODE ADDRESS DO NOT MATCH: ole <0. ce, ee ee Ae a Ae 
HOST NAME ~- NODE ADDRESS DO NOT MATCH. .....-2 2.2... 5-5 
HOST NAME - NODE ADDRESS DO NOT MATCH. ........++5- 3 
HOST NAME DOES NOT MATCH. . . 1... ee ee we we ew ew ew ew He 2 
HOST NOT DELETED. :e 4. eo: 2 we xt ee a es Swe Bee ee Bees 
ILLEGAL PASSWORD. . . Bay Sie fae ca. Mars cee : a oe 
IMPROPER ENSEMBLE KIND. by sp Coven ae GE ene, Ses -. 5-28 
IMPROPER ENSEMBLE TYPE. ..... . 6- 2 
IMPROPER ENSEMBLE TYPE. . ap) ok se as Me Sew, Ge ee ee” 
IMPROPER FILE FORMAT. . . 2. 1. 2. 0 0 ee we ew ew ew ww we ew eh et OM Q 
IMPROPER PARAMETER. . ... . j . 5 - 30 
IMPROPER PHASE. . . er ee ee Se ; ; , ~ 1-15 
IMPROPER SETTING OF STATION ATTRIBUTE . . ; oh ee b= 18 
IMPROPER STATION KIND... . 2.2.2 a os , . 5-28 
IMPROPER STATION TYPE... 2. 2. 2. 2 + 6 we we we ee ~-.- 6- 2 
IMPROPER STATION TYPE .... 2.2 ew we we we we we ww ; .6- 7 
INCORRECT PARAMETERS. . . . . 2. 6 « @ : ‘ eae . 5-28 
INVALID AUTHORIZATION OPTION. .. . gine ee ae -3- 6 
INVALID HOST INACTIVE DISCONNECT OPTION ape Aae se ~ 4-23 
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INDEX4 Error Message Index 
INVALID HOST INACTIVE TIMEOUT... . ~ 4 -23 
INVALID HOST NAME... .....4-. ~5-7 
INVALID HOST NAME... ; ~5-°5 
INVALID HOST UNREACHABLE “TIMEOUT. ~ & -23 
INVALID LINK RESISTANCE FACTOR. ~ 4-17 
INVALID LOGGING OPTION. . Bs Ok dear . & - 8 
INVALID MAX HOP COUNT... 5s Bie ~ 4-15 
INVALID MAX PROGRAM AGENT VALUE Mh 2g d 3-9 
INVALID MAX RESISTANCE FACTOR... . ~& -15 
INVALID MONITOR OPTION. .... ~ 4k - 4) 
INVALID MONITOR TIME INTERVAL... . ~ & -1] 
INVALID NE!GHBOR BUSY TIMEOUT VALUE... ~ 4-25 
INVALID NEIGHBOR GREETING TIMEOUT VALUE . ~ 4-25 
INVALID NEIGHBOR RESTART TIMEOUT VALUE. ~ 4-15 
INVALID NETWORK MAX SEGMENT SIZE. ~h- 6 
INVALID NODE ADDRESS. . ~&- 2 
INVALID NODE ADDRESS. ........ ~5 - 3 
INVALID NODE ADDRESS. ........ ~5- 6 
INVALID NODE ADDRESS. ~-5- 4 
INVALID NODE ADDRESS. ........ ~5- 7 
INVALID NODE ADDRESS. ae « 1-15 
INVALID NODE RESISTANCE FACTOR. aa? ~h -15 
INVALID NODE UP TIMEOUT VALUE ...... ~ A -15 
INVALID PORT COMPRESSION ALLOWED OPTION ‘ ~ & -20 
INVALID PORT LOG TIME INTERVAL. 1... ~ 4 -12 
INVALID PORT RESUME READY FACTOR. . . - & -20 
INVALID PORT RETRY LIMIT. a6 ; ~ 4 -20 
INVALID PORT SEGMENT Ti MEOUT INTERVAL ; . & -20 
INVALID PORT WINDOW SIZE. . . & -20 
INVALID PROFILE REFERENCE... a a5 ~ 5 719 
INVALID PROGRAM AGENT SECURITY OPTION ; .-3- 9 
INVALID REMOTE -HOST . a. Bio ane ~3 711 
INVALID SLM PHASE... aera -7° 3 
INVALID STATION ATTRIBUTE NAME. agg - 5-16 
INVALID STATION ATTRIBUTE VALUE ~ 5-16 
INVALID STATION NAME... 6-9 
INVALID STATION NAME. .. . ; 6 - 8 
INVALID STATION PHASE ON Setations ~7 7 3 
INVALID STATION Ses ta ep oe. . 5 -20 
INVALID TRACE DESTINATION eee ae » 6 -13 
INVALID TRACE SOURCE. Beye ed le Valea 8 » 6 -13 
INVALID USERCODE. ....... se - 3-6 
LAST REMAINING STATION MAY NOT BE DELETED : 5-25 
MESSAGE TEXT EXCEEDS MAX SEGMENT SIZE... ~ 6 -1h 
MISSING NODE ADDRESS. see ee ~5-4 
NEIGHBOR |S NOT A NODE. .......4.6. . 5 -28 
NO CALLS WITH NEIGHBOR EXIST. ...... ~-6-4 
NO FILE BEING LOADED. ... 8 - 3 
NO MORE THAN TWO PROFILES MAY BE “SPECIFIED. ~ 5 -19 
NO STATION AVAILABLE. ........ -6-7 
NO STATION AVAILABLE. Beceem 6-4 9 
NO SUCH <entity>: «0% 2. 6% 2b 6 we 8 es » 1 715 


Error Message Index 


a a ee eee ear 


NO SUCH CONNECTION. ... 2... . 5 -30 
NO SUCH CONNECTION. .. 2.2... 5 §-= 20 
NO SUCH ENSEMBLE. ......... 5 = 25 
NO SUCH ENSEMBLE. ......... aera 
NO SUCH ENSEMBLE. ..... 2... 002. eee eae 6. as 2 
NO SUCH ENSEMBLE. ..... 2.2.5... ee eevee soar 
NO SUCH ENSEMBLE. .........0.208- ore k 
NO SUCH HOST OR NODE. ..........2.64 beth 
NO SUCH HOST OR NODE. ps ado ay ods SSG lee 3 
NO SUCH HOST. ........206- ees 
NO SUCH REMOTE HOST . 6. 4 
NO SUCH REMOTE HOST. .... 6-11 
NO SUCH REMOTE HOST. .... . 6 = 10 
NO SUCH STATION GROUP . . sie Ae * 22 
NO SUCH STATION. ......... .6- 2 
NO SUCH STATION... 2... 2.0 gS 
NO SUCH STATION. ......... a6 8.9 
NO SUCH USERCODE. ee 
NO SUSPENDED FILE. ........605050084 .8- 4 
NO SUSPENDED FILE. ...... eee ee eee fe: oe 
NODE ALREADY ADDED. ............ 5G de dy 
NODE ALREADY DELETED. ........... ey 
NODE NOT DELETED. ......... 2000. ; a, 
NODE NOT DELETED... 2... 2. ee eee wee eee ee 5 HT 
NODE UNREACHABLE. . . . 2. ee ee ee ee ee ee ee ee 6 HTK 
NOT DELETED: 605-54 oe Boa ew Bw de : . 5 - 20 
NOT DELETEO. 6425. dice Se he oe es : . 5 - 20 
NOT DELETED: sic bs a eee Se tS arse ee ae and . 5 -20 
NOT IN NETWORK MODE... . rae ae ere 
<file-title> NOT PRESENT FOR LOADING. .8 - 2 
PROFILE ALREADY DEFINED . 5 -16 
PROFILE NOT DEFINED. ..... sb. ee T7 
ROUTER VALIDATE IS FALSE. . . 5 - k 
SHUTDOWN CANNOT BE CANCELLED. POF foe 
STATION ALREADY CLOSED. . . 4 56 len 
STATION ATTRIBUTE MAY NOT BE SET. 5 bre 2) 
STATION FAILURE . once a6 ec 38 
STATION FAILURE... . 6 7 
STATION NOT AVAILABLE . 5 7 
STATION NOT AVAILABLE . £162: 
STATION NOT CLOSED. ... . es 
STATIONS IN ENSEMBLE NOT OF PROPER TYPE . = 5G Bi0s 
STATIONS IN ENSEMBLE HAVE NOT BEEN ADDED. <5 223 
UNAUTHORIZED AGENT. . . . Bote Day sith asa 
USERCODE MAY NOT BE SPECIFIED... . a eh 
VALIDATE OPTION INVALID . he a ee, 
VALIDATION FAILURE ON <station> . Sat 3 
VALIDATION FAILURE. ...... es 
VALIDATION FAILURE. . e632 
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REPORT INDEX, ALPHABETICAL ORDER 


<neighbor> DISCONNECTED, NEIGHBOR BUSY TIMEOUT EXCEEDED . 


ERROR IN MESSAGE . . 1. 2 1 ee ew we ew we ww 
ERROR IN MESSAGE FROM. . 1. 1. 2 6 ew ee wwe 
FROM . . eae oa gh? Se 


HOST SAVED. ... 

HOST VALIDATION FAILURE ON. Page oie 

LOCAL VALIDATION TO <neighbor> FAILED ON. <station> 
NODE IS NOW... . a 

PLM SUBPORT DIALOG ESTABLISHMENT FAILURE. ‘ ‘ ; 
REMOTE VALIDATION TO <neighbor> FAILED ON etalon: . 
<neighbor> RESTARTING . Bel wit GS ies Gar ads et at 
ROUTING STATUS TO ......... 

ROUTING TRACE FROM 

STATION ‘ 

STATION . 

STATION . 

TEST 


10- 6 
10:="2 
10-10 


oooooooo0oo0o0oo0o°o°c°o 
toboeet tot t t Ff b t tot 
Cc @OmNm FU HA~IO — ~110 WO 
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APPENDIX H 


MINIMUM REQUIREMENTS 
FOR NETWORK OPERATION 


With the exception of any system dependent requirements, the only commands 
necessary to invoke Network Mode are the the Host Name (HN), and a NET + 
command; an optional Initialization File containing at least the local node 
address (LOCALIDENTITY), or LOCALINDENTITY command must be provided, and. the 
command ENDINIT must complete either procedure. 


If the above minimum procedure was adopted, the node would enter the Network 
Mode, but would be unable to communicate with a neighbor node as there would be 
no stations available. Another requirement then, is to enable a station. This 
can be done most simply by ADDING a station, and then causing the station 
attachment by the command ESTABLISH CALL. Having done this, the node will be 
able to communicate with a neighbor, and the network. 


The procedure described above is a minimum requirement, there would be no 
validation provided and al] attributes would be set to the default values. Here 
it should be noted that MAX HOP COUNT and MAX RESISTANCE FACTOR default values 
only represent a smal! network. In particular MAX HOP COUNT's default value is 
5. However, if the most simple case is to be used, it is most likely that these 
values would suffice. 


H-1 


Documentation Evaluation Form 


Title: Burroughs Network Architecture (BNA) == Form No: 1132180 


Network Control Reference Manual (Vol 2) Date: April 1981 


Burroughs Corporation is interested in receiving your comments 
and suggestions regarding this manual. Comments will be util- 
ized in ensuing revisions to improve this manual. 


Please check type of Suggestion: 


O) Addition C) Deletion O Revision O Error 


Comments: 


From: 

Name 
Title 
Company 
Address 


Phone Number Date 


Remove form and mail to: 


Documentation Dept, TIO - East 
Burroughs Corporation 
Box CB7 
Malvern, PA 19355 


~ 


=a 
7 


|Burroughs Network Architecture (BNA) 


7 NETWORK CONTROL 
ds REFERENCE MANUAL VOLUME 2 


2" BINDER 
1%" BINDER 
1” BINDER 


1132180 
Printed in U.S.A. 


11321°9 


April 1981 


Printed in U.S.A. 


